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 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
  43 config 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
  55 config 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
  67 config 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
  81 config 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
  94 config 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
 106 config 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
 118 config 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
 134 config 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
 148 config 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
 159 config 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
 172 config 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"