xref: /linux/drivers/gpu/drm/i915/Kconfig.debug (revision e9f0878c4b2004ac19581274c1ae4c61ae3ca70e)
1config DRM_I915_WERROR
2        bool "Force GCC to throw an error instead of a warning when compiling"
3        # As this may inadvertently break the build, only allow the user
4        # to shoot oneself in the foot iff they aim really hard
5        depends on EXPERT
6        # We use the dependency on !COMPILE_TEST to not be enabled in
7        # allmodconfig or allyesconfig configurations
8        depends on !COMPILE_TEST
9        default n
10        help
11          Add -Werror to the build flags for (and only for) i915.ko.
12          Do not enable this unless you are writing code for the i915.ko module.
13
14          Recommended for driver developers only.
15
16          If in doubt, say "N".
17
18config DRM_I915_DEBUG
19        bool "Enable additional driver debugging"
20        depends on DRM_I915
21        select DEBUG_FS
22        select PREEMPT_COUNT
23        select I2C_CHARDEV
24        select DRM_DP_AUX_CHARDEV
25        select X86_MSR # used by igt/pm_rpm
26        select DRM_VGEM # used by igt/prime_vgem (dmabuf interop checks)
27        select DRM_DEBUG_MM if DRM=y
28        select STACKDEPOT if DRM=y # for DRM_DEBUG_MM
29	select DRM_DEBUG_SELFTEST
30	select SW_SYNC # signaling validation framework (igt/syncobj*)
31	select DRM_I915_SW_FENCE_DEBUG_OBJECTS
32	select DRM_I915_SELFTEST
33        default n
34        help
35          Choose this option to turn on extra driver debugging that may affect
36          performance but will catch some internal issues.
37
38          Recommended for driver developers only.
39
40          If in doubt, say "N".
41
42config DRM_I915_DEBUG_GEM
43        bool "Insert extra checks into the GEM internals"
44        default n
45        depends on DRM_I915_WERROR
46        help
47          Enable extra sanity checks (including BUGs) along the GEM driver
48          paths that may slow the system down and if hit hang the machine.
49
50          Recommended for driver developers only.
51
52          If in doubt, say "N".
53
54config DRM_I915_ERRLOG_GEM
55	bool "Insert extra logging (very verbose) for common GEM errors"
56	default n
57	depends on DRM_I915_DEBUG_GEM
58	help
59	  Enable additional logging that may help track down the cause of
60	  principally userspace errors.
61
62	  Recommended for driver developers only.
63
64	  If in doubt, say "N".
65
66config DRM_I915_TRACE_GEM
67	bool "Insert extra ftrace output from the GEM internals"
68	depends on DRM_I915_DEBUG_GEM
69	select TRACING
70	default n
71	help
72	  Enable additional and verbose debugging output that will spam
73	  ordinary tests, but may be vital for post-mortem debugging when
74	  used with /proc/sys/kernel/ftrace_dump_on_oops
75
76	  Recommended for driver developers only.
77
78	  If in doubt, say "N".
79
80config DRM_I915_SW_FENCE_DEBUG_OBJECTS
81        bool "Enable additional driver debugging for fence objects"
82        depends on DRM_I915
83        select DEBUG_OBJECTS
84        default n
85        help
86          Choose this option to turn on extra driver debugging that may affect
87          performance but will catch some internal issues.
88
89          Recommended for driver developers only.
90
91          If in doubt, say "N".
92
93config DRM_I915_SW_FENCE_CHECK_DAG
94        bool "Enable additional driver debugging for detecting dependency cycles"
95        depends on DRM_I915
96        default n
97        help
98          Choose this option to turn on extra driver debugging that may affect
99          performance but will catch some internal issues.
100
101          Recommended for driver developers only.
102
103          If in doubt, say "N".
104
105config DRM_I915_DEBUG_GUC
106        bool "Enable additional driver debugging for GuC"
107        depends on DRM_I915
108        default n
109        help
110          Choose this option to turn on extra driver debugging that may affect
111          performance but will help resolve GuC related issues.
112
113          Recommended for driver developers only.
114
115          If in doubt, say "N".
116
117config DRM_I915_SELFTEST
118	bool "Enable selftests upon driver load"
119	depends on DRM_I915
120	default n
121	select FAULT_INJECTION
122	select PRIME_NUMBERS
123	help
124	  Choose this option to allow the driver to perform selftests upon
125	  loading; also requires the i915.selftest=1 module parameter. To
126	  exit the module after running the selftests (i.e. to prevent normal
127	  module initialisation afterwards) use i915.selftest=-1.
128
129	  Recommended for driver developers only.
130
131	  If in doubt, say "N".
132
133config DRM_I915_SELFTEST_BROKEN
134	bool "Enable broken and dangerous selftests"
135	depends on DRM_I915_SELFTEST
136	depends on BROKEN
137	default n
138	help
139	  This option enables the execution of selftests that are "dangerous"
140	  and may trigger unintended HW side-effects as they break strict
141	  rules given in the HW specification. For science.
142
143	  Recommended for masochistic driver developers only.
144
145	  If in doubt, say "N".
146
147config DRM_I915_LOW_LEVEL_TRACEPOINTS
148        bool "Enable low level request tracing events"
149        depends on DRM_I915
150        default n
151        help
152          Choose this option to turn on low level request tracing events.
153          This provides the ability to precisely monitor engine utilisation
154          and also analyze the request dependency resolving timeline.
155
156          If in doubt, say "N".
157
158config DRM_I915_DEBUG_VBLANK_EVADE
159	bool "Enable extra debug warnings for vblank evasion"
160	depends on DRM_I915
161	default n
162	help
163	  Choose this option to turn on extra debug warnings for the
164	  vblank evade mechanism. This gives a warning every time the
165	  the deadline allotted for the vblank evade critical section
166	  is exceeded, even if there isn't an actual risk of missing
167	  the vblank.
168
169	  If in doubt, say "N".
170