Merge tag 'clang-format-for-linus-v4.19' of git://github.com/ojeda/linux
[sfrench/cifs-2.6.git] / drivers / gpu / drm / i915 / Kconfig.debug
1 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.
13
14           Recommended for driver developers only.
15
16           If in doubt, say "N".
17
18 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
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         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.
37
38           Recommended for driver developers only.
39
40           If in doubt, say "N".
41
42 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.
49
50           Recommended for driver developers only.
51
52           If in doubt, say "N".
53
54 config DRM_I915_ERRLOG_GEM
55         bool "Insert extra logging (very verbose) for common GEM errors"
56         default n
57         depends on DRM_I915_DEBUG_GEM
58         help
59           Enable additional logging that may help track down the cause of
60           principally userspace errors.
61
62           Recommended for driver developers only.
63
64           If in doubt, say "N".
65
66 config DRM_I915_TRACE_GEM
67         bool "Insert extra ftrace output from the GEM internals"
68         depends on DRM_I915_DEBUG_GEM
69         select TRACING
70         default n
71         help
72           Enable additional and verbose debugging output that will spam
73           ordinary tests, but may be vital for post-mortem debugging when
74           used with /proc/sys/kernel/ftrace_dump_on_oops
75
76           Recommended for driver developers only.
77
78           If in doubt, say "N".
79
80 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.
88
89           Recommended for driver developers only.
90
91           If in doubt, say "N".
92
93 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.
100
101           Recommended for driver developers only.
102
103           If in doubt, say "N".
104
105 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.
112
113           Recommended for driver developers only.
114
115           If in doubt, say "N".
116
117 config DRM_I915_SELFTEST
118         bool "Enable selftests upon driver load"
119         depends on DRM_I915
120         default n
121         select FAULT_INJECTION
122         select PRIME_NUMBERS
123         help
124           Choose this option to allow the driver to perform selftests upon
125           loading; also requires the i915.selftest=1 module parameter. To
126           exit the module after running the selftests (i.e. to prevent normal
127           module initialisation afterwards) use i915.selftest=-1.
128
129           Recommended for driver developers only.
130
131           If in doubt, say "N".
132
133 config DRM_I915_SELFTEST_BROKEN
134         bool "Enable broken and dangerous selftests"
135         depends on DRM_I915_SELFTEST
136         depends on BROKEN
137         default n
138         help
139           This option enables the execution of selftests that are "dangerous"
140           and may trigger unintended HW side-effects as they break strict
141           rules given in the HW specification. For science.
142
143           Recommended for masochistic driver developers only.
144
145           If in doubt, say "N".
146
147 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.
155
156           If in doubt, say "N".
157
158 config DRM_I915_DEBUG_VBLANK_EVADE
159         bool "Enable extra debug warnings for vblank evasion"
160         depends on DRM_I915
161         default n
162         help
163           Choose this option to turn on extra debug warnings for the
164           vblank evade mechanism. This gives a warning every time the
165           the deadline allotted for the vblank evade critical section
166           is exceeded, even if there isn't an actual risk of missing
167           the vblank.
168
169           If in doubt, say "N".