Loading...
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 depends on EXPERT # only for developers
23 depends on !COMPILE_TEST # never built by robots
24 select DEBUG_FS
25 select PREEMPT_COUNT
26 select I2C_CHARDEV
27 select STACKDEPOT
28 select DRM_DP_AUX_CHARDEV
29 select X86_MSR # used by igt/pm_rpm
30 select DRM_VGEM # used by igt/prime_vgem (dmabuf interop checks)
31 select DRM_DEBUG_MM if DRM=y
32 select DRM_EXPORT_FOR_TESTS if m
33 select DRM_DEBUG_SELFTEST
34 select DMABUF_SELFTESTS
35 select SW_SYNC # signaling validation framework (igt/syncobj*)
36 select DRM_I915_WERROR
37 select DRM_I915_DEBUG_GEM
38 select DRM_I915_DEBUG_GEM_ONCE
39 select DRM_I915_DEBUG_MMIO
40 select DRM_I915_DEBUG_RUNTIME_PM
41 select DRM_I915_SW_FENCE_DEBUG_OBJECTS
42 select DRM_I915_SELFTEST
43 default n
44 help
45 Choose this option to turn on extra driver debugging that may affect
46 performance but will catch some internal issues.
47
48 Recommended for driver developers only.
49
50 If in doubt, say "N".
51
52config DRM_I915_DEBUG_MMIO
53 bool "Always insert extra checks around mmio access by default"
54 default n
55 help
56 By default, always enables the extra sanity checks (extra register
57 reads) around every mmio (register) access that will slow the system
58 down. This sets the default value of i915.mmio_debug to -1 and can
59 be overridden at module load.
60
61 Recommended for driver developers only.
62
63 If in doubt, say "N".
64
65config DRM_I915_DEBUG_GEM
66 bool "Insert extra checks into the GEM internals"
67 default n
68 depends on DRM_I915_WERROR
69 help
70 Enable extra sanity checks (including BUGs) along the GEM driver
71 paths that may slow the system down and if hit hang the machine.
72
73 Recommended for driver developers only.
74
75 If in doubt, say "N".
76
77config DRM_I915_DEBUG_GEM_ONCE
78 bool "Make a GEM debug failure fatal"
79 default n
80 depends on DRM_I915_DEBUG_GEM
81 help
82 During development, we often only want the very first failure
83 as that would otherwise be lost in the deluge of subsequent
84 failures. However, more casual testers may not want to trigger
85 a hard BUG_ON and hope that the system remains sufficiently usable
86 to capture a bug report in situ.
87
88 Recommended for driver developers only.
89
90 If in doubt, say "N".
91
92config DRM_I915_ERRLOG_GEM
93 bool "Insert extra logging (very verbose) for common GEM errors"
94 default n
95 depends on DRM_I915_DEBUG_GEM
96 help
97 Enable additional logging that may help track down the cause of
98 principally userspace errors.
99
100 Recommended for driver developers only.
101
102 If in doubt, say "N".
103
104config DRM_I915_TRACE_GEM
105 bool "Insert extra ftrace output from the GEM internals"
106 depends on DRM_I915_DEBUG_GEM
107 select TRACING
108 default n
109 help
110 Enable additional and verbose debugging output that will spam
111 ordinary tests, but may be vital for post-mortem debugging when
112 used with /proc/sys/kernel/ftrace_dump_on_oops
113
114 Recommended for driver developers only.
115
116 If in doubt, say "N".
117
118config DRM_I915_TRACE_GTT
119 bool "Insert extra ftrace output from the GTT internals"
120 depends on DRM_I915_DEBUG_GEM
121 select TRACING
122 default n
123 help
124 Enable additional and verbose debugging output that will spam
125 ordinary tests, but may be vital for post-mortem debugging when
126 used with /proc/sys/kernel/ftrace_dump_on_oops
127
128 Recommended for driver developers only.
129
130 If in doubt, say "N".
131
132config DRM_I915_SW_FENCE_DEBUG_OBJECTS
133 bool "Enable additional driver debugging for fence objects"
134 depends on DRM_I915
135 select DEBUG_OBJECTS
136 default n
137 help
138 Choose this option to turn on extra driver debugging that may affect
139 performance but will catch some internal issues.
140
141 Recommended for driver developers only.
142
143 If in doubt, say "N".
144
145config DRM_I915_SW_FENCE_CHECK_DAG
146 bool "Enable additional driver debugging for detecting dependency cycles"
147 depends on DRM_I915
148 default n
149 help
150 Choose this option to turn on extra driver debugging that may affect
151 performance but will catch some internal issues.
152
153 Recommended for driver developers only.
154
155 If in doubt, say "N".
156
157config DRM_I915_DEBUG_GUC
158 bool "Enable additional driver debugging for GuC"
159 depends on DRM_I915
160 default n
161 help
162 Choose this option to turn on extra driver debugging that may affect
163 performance but will help resolve GuC related issues.
164
165 Recommended for driver developers only.
166
167 If in doubt, say "N".
168
169config DRM_I915_SELFTEST
170 bool "Enable selftests upon driver load"
171 depends on DRM_I915
172 default n
173 select DRM_EXPORT_FOR_TESTS if m
174 select FAULT_INJECTION
175 select PRIME_NUMBERS
176 select CRC32
177 help
178 Choose this option to allow the driver to perform selftests upon
179 loading; also requires the i915.selftest=1 module parameter. To
180 exit the module after running the selftests (i.e. to prevent normal
181 module initialisation afterwards) use i915.selftest=-1.
182
183 Recommended for driver developers only.
184
185 If in doubt, say "N".
186
187config DRM_I915_SELFTEST_BROKEN
188 bool "Enable broken and dangerous selftests"
189 depends on DRM_I915_SELFTEST
190 depends on BROKEN
191 default n
192 help
193 This option enables the execution of selftests that are "dangerous"
194 and may trigger unintended HW side-effects as they break strict
195 rules given in the HW specification. For science.
196
197 Recommended for masochistic driver developers only.
198
199 If in doubt, say "N".
200
201config DRM_I915_LOW_LEVEL_TRACEPOINTS
202 bool "Enable low level request tracing events"
203 depends on DRM_I915
204 default n
205 help
206 Choose this option to turn on low level request tracing events.
207 This provides the ability to precisely monitor engine utilisation
208 and also analyze the request dependency resolving timeline.
209
210 If in doubt, say "N".
211
212config DRM_I915_DEBUG_VBLANK_EVADE
213 bool "Enable extra debug warnings for vblank evasion"
214 depends on DRM_I915
215 default n
216 help
217 Choose this option to turn on extra debug warnings for the
218 vblank evade mechanism. This gives a warning every time the
219 the deadline allotted for the vblank evade critical section
220 is exceeded, even if there isn't an actual risk of missing
221 the vblank.
222
223 If in doubt, say "N".
224
225config DRM_I915_DEBUG_RUNTIME_PM
226 bool "Enable extra state checking for runtime PM"
227 depends on DRM_I915
228 default n
229 select STACKDEPOT
230 help
231 Choose this option to turn on extra state checking for the
232 runtime PM functionality. This may introduce overhead during
233 driver loading, suspend and resume operations.
234
235 If in doubt, say "N"
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 help
157 Choose this option to allow the driver to perform selftests upon
158 loading; also requires the i915.selftest=1 module parameter. To
159 exit the module after running the selftests (i.e. to prevent normal
160 module initialisation afterwards) use i915.selftest=-1.
161
162 Recommended for driver developers only.
163
164 If in doubt, say "N".
165
166config DRM_I915_SELFTEST_BROKEN
167 bool "Enable broken and dangerous selftests"
168 depends on DRM_I915_SELFTEST
169 depends on BROKEN
170 default n
171 help
172 This option enables the execution of selftests that are "dangerous"
173 and may trigger unintended HW side-effects as they break strict
174 rules given in the HW specification. For science.
175
176 Recommended for masochistic driver developers only.
177
178 If in doubt, say "N".
179
180config DRM_I915_LOW_LEVEL_TRACEPOINTS
181 bool "Enable low level request tracing events"
182 depends on DRM_I915
183 default n
184 help
185 Choose this option to turn on low level request tracing events.
186 This provides the ability to precisely monitor engine utilisation
187 and also analyze the request dependency resolving timeline.
188
189 If in doubt, say "N".
190
191config DRM_I915_DEBUG_VBLANK_EVADE
192 bool "Enable extra debug warnings for vblank evasion"
193 depends on DRM_I915
194 default n
195 help
196 Choose this option to turn on extra debug warnings for the
197 vblank evade mechanism. This gives a warning every time the
198 the deadline allotted for the vblank evade critical section
199 is exceeded, even if there isn't an actual risk of missing
200 the vblank.
201
202 If in doubt, say "N".
203
204config DRM_I915_DEBUG_RUNTIME_PM
205 bool "Enable extra state checking for runtime PM"
206 depends on DRM_I915
207 default n
208 select STACKDEPOT
209 help
210 Choose this option to turn on extra state checking for the
211 runtime PM functionality. This may introduce overhead during
212 driver loading, suspend and resume operations.
213
214 If in doubt, say "N"