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