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