hc
2023-12-06 08f87f769b595151be1afeff53e144f543faa614
kernel/drivers/gpu/drm/i915/Kconfig.debug
....@@ -1,55 +1,73 @@
1
+# SPDX-License-Identifier: GPL-2.0-only
12 config 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.
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.
1314
14
- Recommended for driver developers only.
15
+ Recommended for driver developers only.
1516
16
- If in doubt, say "N".
17
+ If in doubt, say "N".
1718
1819 config 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
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
2931 select DRM_DEBUG_SELFTEST
32
+ select DMABUF_SELFTESTS
3033 select SW_SYNC # signaling validation framework (igt/syncobj*)
3134 select DRM_I915_SW_FENCE_DEBUG_OBJECTS
3235 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.
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.
3742
38
- Recommended for driver developers only.
43
+ Recommended for driver developers only.
3944
40
- If in doubt, say "N".
45
+ If in doubt, say "N".
46
+
47
+config 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".
4159
4260 config 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.
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.
4967
50
- Recommended for driver developers only.
68
+ Recommended for driver developers only.
5169
52
- If in doubt, say "N".
70
+ If in doubt, say "N".
5371
5472 config DRM_I915_ERRLOG_GEM
5573 bool "Insert extra logging (very verbose) for common GEM errors"
....@@ -77,49 +95,65 @@
7795
7896 If in doubt, say "N".
7997
98
+config 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
+
80112 config 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.
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.
88120
89
- Recommended for driver developers only.
121
+ Recommended for driver developers only.
90122
91
- If in doubt, say "N".
123
+ If in doubt, say "N".
92124
93125 config 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.
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.
100132
101
- Recommended for driver developers only.
133
+ Recommended for driver developers only.
102134
103
- If in doubt, say "N".
135
+ If in doubt, say "N".
104136
105137 config 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.
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.
112144
113
- Recommended for driver developers only.
145
+ Recommended for driver developers only.
114146
115
- If in doubt, say "N".
147
+ If in doubt, say "N".
116148
117149 config DRM_I915_SELFTEST
118150 bool "Enable selftests upon driver load"
119151 depends on DRM_I915
120152 default n
153
+ select DRM_EXPORT_FOR_TESTS if m
121154 select FAULT_INJECTION
122155 select PRIME_NUMBERS
156
+ select CRC32
123157 help
124158 Choose this option to allow the driver to perform selftests upon
125159 loading; also requires the i915.selftest=1 module parameter. To
....@@ -145,15 +179,15 @@
145179 If in doubt, say "N".
146180
147181 config 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.
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.
155189
156
- If in doubt, say "N".
190
+ If in doubt, say "N".
157191
158192 config DRM_I915_DEBUG_VBLANK_EVADE
159193 bool "Enable extra debug warnings for vblank evasion"
....@@ -167,3 +201,15 @@
167201 the vblank.
168202
169203 If in doubt, say "N".
204
+
205
+config 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"