Kconfig.debug (7192B)
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 Recommended for driver developers only. 211 212 If in doubt, say "N". 213 214config DRM_I915_DEBUG_VBLANK_EVADE 215 bool "Enable extra debug warnings for vblank evasion" 216 depends on DRM_I915 217 default n 218 help 219 Choose this option to turn on extra debug warnings for the 220 vblank evade mechanism. This gives a warning every time the 221 the deadline allotted for the vblank evade critical section 222 is exceeded, even if there isn't an actual risk of missing 223 the vblank. 224 225 Recommended for driver developers only. 226 227 If in doubt, say "N". 228 229config DRM_I915_DEBUG_RUNTIME_PM 230 bool "Enable extra state checking for runtime PM" 231 depends on DRM_I915 232 default n 233 select STACKDEPOT 234 help 235 Choose this option to turn on extra state checking for the 236 runtime PM functionality. This may introduce overhead during 237 driver loading, suspend and resume operations. 238 239 Recommended for driver developers only. 240 241 If in doubt, say "N"