xref: /openbmc/linux/drivers/gpu/drm/i915/Kconfig.debug (revision ae40e94f)
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 STACKDEPOT
25        select DRM_DP_AUX_CHARDEV
26        select X86_MSR # used by igt/pm_rpm
27        select DRM_VGEM # used by igt/prime_vgem (dmabuf interop checks)
28        select DRM_DEBUG_MM if DRM=y
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	select DRM_I915_DEBUG_RUNTIME_PM
34        default n
35        help
36          Choose this option to turn on extra driver debugging that may affect
37          performance but will catch some internal issues.
38
39          Recommended for driver developers only.
40
41          If in doubt, say "N".
42
43config DRM_I915_DEBUG_GEM
44        bool "Insert extra checks into the GEM internals"
45        default n
46        depends on DRM_I915_WERROR
47        help
48          Enable extra sanity checks (including BUGs) along the GEM driver
49          paths that may slow the system down and if hit hang the machine.
50
51          Recommended for driver developers only.
52
53          If in doubt, say "N".
54
55config DRM_I915_ERRLOG_GEM
56	bool "Insert extra logging (very verbose) for common GEM errors"
57	default n
58	depends on DRM_I915_DEBUG_GEM
59	help
60	  Enable additional logging that may help track down the cause of
61	  principally userspace errors.
62
63	  Recommended for driver developers only.
64
65	  If in doubt, say "N".
66
67config DRM_I915_TRACE_GEM
68	bool "Insert extra ftrace output from the GEM internals"
69	depends on DRM_I915_DEBUG_GEM
70	select TRACING
71	default n
72	help
73	  Enable additional and verbose debugging output that will spam
74	  ordinary tests, but may be vital for post-mortem debugging when
75	  used with /proc/sys/kernel/ftrace_dump_on_oops
76
77	  Recommended for driver developers only.
78
79	  If in doubt, say "N".
80
81config DRM_I915_SW_FENCE_DEBUG_OBJECTS
82        bool "Enable additional driver debugging for fence objects"
83        depends on DRM_I915
84        select DEBUG_OBJECTS
85        default n
86        help
87          Choose this option to turn on extra driver debugging that may affect
88          performance but will catch some internal issues.
89
90          Recommended for driver developers only.
91
92          If in doubt, say "N".
93
94config DRM_I915_SW_FENCE_CHECK_DAG
95        bool "Enable additional driver debugging for detecting dependency cycles"
96        depends on DRM_I915
97        default n
98        help
99          Choose this option to turn on extra driver debugging that may affect
100          performance but will catch some internal issues.
101
102          Recommended for driver developers only.
103
104          If in doubt, say "N".
105
106config DRM_I915_DEBUG_GUC
107        bool "Enable additional driver debugging for GuC"
108        depends on DRM_I915
109        default n
110        help
111          Choose this option to turn on extra driver debugging that may affect
112          performance but will help resolve GuC related issues.
113
114          Recommended for driver developers only.
115
116          If in doubt, say "N".
117
118config DRM_I915_SELFTEST
119	bool "Enable selftests upon driver load"
120	depends on DRM_I915
121	default n
122	select FAULT_INJECTION
123	select PRIME_NUMBERS
124	help
125	  Choose this option to allow the driver to perform selftests upon
126	  loading; also requires the i915.selftest=1 module parameter. To
127	  exit the module after running the selftests (i.e. to prevent normal
128	  module initialisation afterwards) use i915.selftest=-1.
129
130	  Recommended for driver developers only.
131
132	  If in doubt, say "N".
133
134config DRM_I915_SELFTEST_BROKEN
135	bool "Enable broken and dangerous selftests"
136	depends on DRM_I915_SELFTEST
137	depends on BROKEN
138	default n
139	help
140	  This option enables the execution of selftests that are "dangerous"
141	  and may trigger unintended HW side-effects as they break strict
142	  rules given in the HW specification. For science.
143
144	  Recommended for masochistic driver developers only.
145
146	  If in doubt, say "N".
147
148config DRM_I915_LOW_LEVEL_TRACEPOINTS
149        bool "Enable low level request tracing events"
150        depends on DRM_I915
151        default n
152        help
153          Choose this option to turn on low level request tracing events.
154          This provides the ability to precisely monitor engine utilisation
155          and also analyze the request dependency resolving timeline.
156
157          If in doubt, say "N".
158
159config DRM_I915_DEBUG_VBLANK_EVADE
160	bool "Enable extra debug warnings for vblank evasion"
161	depends on DRM_I915
162	default n
163	help
164	  Choose this option to turn on extra debug warnings for the
165	  vblank evade mechanism. This gives a warning every time the
166	  the deadline allotted for the vblank evade critical section
167	  is exceeded, even if there isn't an actual risk of missing
168	  the vblank.
169
170	  If in doubt, say "N".
171
172config DRM_I915_DEBUG_RUNTIME_PM
173	bool "Enable extra state checking for runtime PM"
174	depends on DRM_I915
175	default n
176	select STACKDEPOT
177	help
178	  Choose this option to turn on extra state checking for the
179	  runtime PM functionality. This may introduce overhead during
180	  driver loading, suspend and resume operations.
181
182	  If in doubt, say "N"
183