drivers/gpu/drm/i915/Kconfig.debug

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 config 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         select HEADER_TEST
  11         default n
  12         help
  13           Add -Werror to the build flags for (and only for) i915.ko.
  14           Do not enable this unless you are writing code for the i915.ko module.
  15
  16           Recommended for driver developers only.
  17
  18           If in doubt, say "N".
  19
  20 config DRM_I915_DEBUG
  21         bool "Enable additional driver debugging"
  22         depends on DRM_I915
  23         select DEBUG_FS
  24         select PREEMPT_COUNT
  25         select REFCOUNT_FULL
  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_SW_FENCE_DEBUG_OBJECTS
  37         select DRM_I915_SELFTEST
  38         select DRM_I915_DEBUG_RUNTIME_PM
  39         select DRM_I915_DEBUG_MMIO
  40         default n
  41         help
  42           Choose this option to turn on extra driver debugging that may affect
  43           performance but will catch some internal issues.
  44
  45           Recommended for driver developers only.
  46
  47           If in doubt, say "N".
  48
  49 config DRM_I915_DEBUG_MMIO
  50         bool "Always insert extra checks around mmio access by default"
  51         default n
  52         help
  53           By default, always enables the extra sanity checks (extra register
  54           reads) around every mmio (register) access that will slow the system
  55           down. This sets the default value of i915.mmio_debug to -1 and can
  56           be overridden at module load.
  57
  58           Recommended for driver developers only.
  59
  60           If in doubt, say "N".
  61
  62 config DRM_I915_DEBUG_GEM
  63         bool "Insert extra checks into the GEM internals"
  64         default n
  65         depends on DRM_I915_WERROR
  66         help
  67           Enable extra sanity checks (including BUGs) along the GEM driver
  68           paths that may slow the system down and if hit hang the machine.
  69
  70           Recommended for driver developers only.
  71
  72           If in doubt, say "N".
  73
  74 config DRM_I915_ERRLOG_GEM
  75         bool "Insert extra logging (very verbose) for common GEM errors"
  76         default n
  77         depends on DRM_I915_DEBUG_GEM
  78         help
  79           Enable additional logging that may help track down the cause of
  80           principally userspace errors.
  81
  82           Recommended for driver developers only.
  83
  84           If in doubt, say "N".
  85
  86 config DRM_I915_TRACE_GEM
  87         bool "Insert extra ftrace output from the GEM internals"
  88         depends on DRM_I915_DEBUG_GEM
  89         select TRACING
  90         default n
  91         help
  92           Enable additional and verbose debugging output that will spam
  93           ordinary tests, but may be vital for post-mortem debugging when
  94           used with /proc/sys/kernel/ftrace_dump_on_oops
  95
  96           Recommended for driver developers only.
  97
  98           If in doubt, say "N".
  99
 100 config DRM_I915_TRACE_GTT
 101         bool "Insert extra ftrace output from the GTT internals"
 102         depends on DRM_I915_DEBUG_GEM
 103         select TRACING
 104         default n
 105         help
 106           Enable additional and verbose debugging output that will spam
 107           ordinary tests, but may be vital for post-mortem debugging when
 108           used with /proc/sys/kernel/ftrace_dump_on_oops
 109
 110           Recommended for driver developers only.
 111
 112           If in doubt, say "N".
 113
 114 config DRM_I915_SW_FENCE_DEBUG_OBJECTS
 115         bool "Enable additional driver debugging for fence objects"
 116         depends on DRM_I915
 117         select DEBUG_OBJECTS
 118         default n
 119         help
 120           Choose this option to turn on extra driver debugging that may affect
 121           performance but will catch some internal issues.
 122
 123           Recommended for driver developers only.
 124
 125           If in doubt, say "N".
 126
 127 config DRM_I915_SW_FENCE_CHECK_DAG
 128         bool "Enable additional driver debugging for detecting dependency cycles"
 129         depends on DRM_I915
 130         default n
 131         help
 132           Choose this option to turn on extra driver debugging that may affect
 133           performance but will catch some internal issues.
 134
 135           Recommended for driver developers only.
 136
 137           If in doubt, say "N".
 138
 139 config DRM_I915_DEBUG_GUC
 140         bool "Enable additional driver debugging for GuC"
 141         depends on DRM_I915
 142         default n
 143         help
 144           Choose this option to turn on extra driver debugging that may affect
 145           performance but will help resolve GuC related issues.
 146
 147           Recommended for driver developers only.
 148
 149           If in doubt, say "N".
 150
 151 config DRM_I915_SELFTEST
 152         bool "Enable selftests upon driver load"
 153         depends on DRM_I915
 154         default n
 155         select DRM_EXPORT_FOR_TESTS if m
 156         select FAULT_INJECTION
 157         select PRIME_NUMBERS
 158         help
 159           Choose this option to allow the driver to perform selftests upon
 160           loading; also requires the i915.selftest=1 module parameter. To
 161           exit the module after running the selftests (i.e. to prevent normal
 162           module initialisation afterwards) use i915.selftest=-1.
 163
 164           Recommended for driver developers only.
 165
 166           If in doubt, say "N".
 167
 168 config DRM_I915_SELFTEST_BROKEN
 169         bool "Enable broken and dangerous selftests"
 170         depends on DRM_I915_SELFTEST
 171         depends on BROKEN
 172         default n
 173         help
 174           This option enables the execution of selftests that are "dangerous"
 175           and may trigger unintended HW side-effects as they break strict
 176           rules given in the HW specification. For science.
 177
 178           Recommended for masochistic driver developers only.
 179
 180           If in doubt, say "N".
 181
 182 config DRM_I915_LOW_LEVEL_TRACEPOINTS
 183         bool "Enable low level request tracing events"
 184         depends on DRM_I915
 185         default n
 186         help
 187           Choose this option to turn on low level request tracing events.
 188           This provides the ability to precisely monitor engine utilisation
 189           and also analyze the request dependency resolving timeline.
 190
 191           If in doubt, say "N".
 192
 193 config DRM_I915_DEBUG_VBLANK_EVADE
 194         bool "Enable extra debug warnings for vblank evasion"
 195         depends on DRM_I915
 196         default n
 197         help
 198           Choose this option to turn on extra debug warnings for the
 199           vblank evade mechanism. This gives a warning every time the
 200           the deadline allotted for the vblank evade critical section
 201           is exceeded, even if there isn't an actual risk of missing
 202           the vblank.
 203
 204           If in doubt, say "N".
 205
 206 config DRM_I915_DEBUG_RUNTIME_PM
 207         bool "Enable extra state checking for runtime PM"
 208         depends on DRM_I915
 209         default n
 210         select STACKDEPOT
 211         help
 212           Choose this option to turn on extra state checking for the
 213           runtime PM functionality. This may introduce overhead during
 214           driver loading, suspend and resume operations.
 215
 216           If in doubt, say "N"