0001 # SPDX-License-Identifier: GPL-2.0-only
0002 config DRM_I915_WERROR
0003 bool "Force GCC to throw an error instead of a warning when compiling"
0004 # As this may inadvertently break the build, only allow the user
0005 # to shoot oneself in the foot iff they aim really hard
0006 depends on EXPERT
0007 # We use the dependency on !COMPILE_TEST to not be enabled in
0008 # allmodconfig or allyesconfig configurations
0009 depends on !COMPILE_TEST
0010 default n
0011 help
0012 Add -Werror to the build flags for (and only for) i915.ko.
0013 Do not enable this unless you are writing code for the i915.ko module.
0014
0015 Recommended for driver developers only.
0016
0017 If in doubt, say "N".
0018
0019 config DRM_I915_DEBUG
0020 bool "Enable additional driver debugging"
0021 depends on DRM_I915
0022 depends on EXPERT # only for developers
0023 depends on !COMPILE_TEST # never built by robots
0024 select DEBUG_FS
0025 select PREEMPT_COUNT
0026 select I2C_CHARDEV
0027 select STACKDEPOT
0028 select DRM_DP_AUX_CHARDEV
0029 select X86_MSR # used by igt/pm_rpm
0030 select DRM_VGEM # used by igt/prime_vgem (dmabuf interop checks)
0031 select DRM_DEBUG_MM if DRM=y
0032 select DRM_EXPORT_FOR_TESTS if m
0033 select DRM_DEBUG_SELFTEST
0034 select DMABUF_SELFTESTS
0035 select SW_SYNC # signaling validation framework (igt/syncobj*)
0036 select DRM_I915_WERROR
0037 select DRM_I915_DEBUG_GEM
0038 select DRM_I915_DEBUG_GEM_ONCE
0039 select DRM_I915_DEBUG_MMIO
0040 select DRM_I915_DEBUG_RUNTIME_PM
0041 select DRM_I915_SW_FENCE_DEBUG_OBJECTS
0042 select DRM_I915_SELFTEST
0043 default n
0044 help
0045 Choose this option to turn on extra driver debugging that may affect
0046 performance but will catch some internal issues.
0047
0048 Recommended for driver developers only.
0049
0050 If in doubt, say "N".
0051
0052 config DRM_I915_DEBUG_MMIO
0053 bool "Always insert extra checks around mmio access by default"
0054 default n
0055 help
0056 By default, always enables the extra sanity checks (extra register
0057 reads) around every mmio (register) access that will slow the system
0058 down. This sets the default value of i915.mmio_debug to -1 and can
0059 be overridden at module load.
0060
0061 Recommended for driver developers only.
0062
0063 If in doubt, say "N".
0064
0065 config DRM_I915_DEBUG_GEM
0066 bool "Insert extra checks into the GEM internals"
0067 default n
0068 depends on DRM_I915_WERROR
0069 help
0070 Enable extra sanity checks (including BUGs) along the GEM driver
0071 paths that may slow the system down and if hit hang the machine.
0072
0073 Recommended for driver developers only.
0074
0075 If in doubt, say "N".
0076
0077 config DRM_I915_DEBUG_GEM_ONCE
0078 bool "Make a GEM debug failure fatal"
0079 default n
0080 depends on DRM_I915_DEBUG_GEM
0081 help
0082 During development, we often only want the very first failure
0083 as that would otherwise be lost in the deluge of subsequent
0084 failures. However, more casual testers may not want to trigger
0085 a hard BUG_ON and hope that the system remains sufficiently usable
0086 to capture a bug report in situ.
0087
0088 Recommended for driver developers only.
0089
0090 If in doubt, say "N".
0091
0092 config DRM_I915_ERRLOG_GEM
0093 bool "Insert extra logging (very verbose) for common GEM errors"
0094 default n
0095 depends on DRM_I915_DEBUG_GEM
0096 help
0097 Enable additional logging that may help track down the cause of
0098 principally userspace errors.
0099
0100 Recommended for driver developers only.
0101
0102 If in doubt, say "N".
0103
0104 config DRM_I915_TRACE_GEM
0105 bool "Insert extra ftrace output from the GEM internals"
0106 depends on DRM_I915_DEBUG_GEM
0107 select TRACING
0108 default n
0109 help
0110 Enable additional and verbose debugging output that will spam
0111 ordinary tests, but may be vital for post-mortem debugging when
0112 used with /proc/sys/kernel/ftrace_dump_on_oops
0113
0114 Recommended for driver developers only.
0115
0116 If in doubt, say "N".
0117
0118 config DRM_I915_TRACE_GTT
0119 bool "Insert extra ftrace output from the GTT internals"
0120 depends on DRM_I915_DEBUG_GEM
0121 select TRACING
0122 default n
0123 help
0124 Enable additional and verbose debugging output that will spam
0125 ordinary tests, but may be vital for post-mortem debugging when
0126 used with /proc/sys/kernel/ftrace_dump_on_oops
0127
0128 Recommended for driver developers only.
0129
0130 If in doubt, say "N".
0131
0132 config DRM_I915_SW_FENCE_DEBUG_OBJECTS
0133 bool "Enable additional driver debugging for fence objects"
0134 depends on DRM_I915
0135 select DEBUG_OBJECTS
0136 default n
0137 help
0138 Choose this option to turn on extra driver debugging that may affect
0139 performance but will catch some internal issues.
0140
0141 Recommended for driver developers only.
0142
0143 If in doubt, say "N".
0144
0145 config DRM_I915_SW_FENCE_CHECK_DAG
0146 bool "Enable additional driver debugging for detecting dependency cycles"
0147 depends on DRM_I915
0148 default n
0149 help
0150 Choose this option to turn on extra driver debugging that may affect
0151 performance but will catch some internal issues.
0152
0153 Recommended for driver developers only.
0154
0155 If in doubt, say "N".
0156
0157 config DRM_I915_DEBUG_GUC
0158 bool "Enable additional driver debugging for GuC"
0159 depends on DRM_I915
0160 default n
0161 help
0162 Choose this option to turn on extra driver debugging that may affect
0163 performance but will help resolve GuC related issues.
0164
0165 Recommended for driver developers only.
0166
0167 If in doubt, say "N".
0168
0169 config DRM_I915_SELFTEST
0170 bool "Enable selftests upon driver load"
0171 depends on DRM_I915
0172 default n
0173 select DRM_EXPORT_FOR_TESTS if m
0174 select FAULT_INJECTION
0175 select PRIME_NUMBERS
0176 select CRC32
0177 help
0178 Choose this option to allow the driver to perform selftests upon
0179 loading; also requires the i915.selftest=1 module parameter. To
0180 exit the module after running the selftests (i.e. to prevent normal
0181 module initialisation afterwards) use i915.selftest=-1.
0182
0183 Recommended for driver developers only.
0184
0185 If in doubt, say "N".
0186
0187 config DRM_I915_SELFTEST_BROKEN
0188 bool "Enable broken and dangerous selftests"
0189 depends on DRM_I915_SELFTEST
0190 depends on BROKEN
0191 default n
0192 help
0193 This option enables the execution of selftests that are "dangerous"
0194 and may trigger unintended HW side-effects as they break strict
0195 rules given in the HW specification. For science.
0196
0197 Recommended for masochistic driver developers only.
0198
0199 If in doubt, say "N".
0200
0201 config DRM_I915_LOW_LEVEL_TRACEPOINTS
0202 bool "Enable low level request tracing events"
0203 depends on DRM_I915
0204 default n
0205 help
0206 Choose this option to turn on low level request tracing events.
0207 This provides the ability to precisely monitor engine utilisation
0208 and also analyze the request dependency resolving timeline.
0209
0210 Recommended for driver developers only.
0211
0212 If in doubt, say "N".
0213
0214 config DRM_I915_DEBUG_VBLANK_EVADE
0215 bool "Enable extra debug warnings for vblank evasion"
0216 depends on DRM_I915
0217 default n
0218 help
0219 Choose this option to turn on extra debug warnings for the
0220 vblank evade mechanism. This gives a warning every time the
0221 the deadline allotted for the vblank evade critical section
0222 is exceeded, even if there isn't an actual risk of missing
0223 the vblank.
0224
0225 Recommended for driver developers only.
0226
0227 If in doubt, say "N".
0228
0229 config DRM_I915_DEBUG_RUNTIME_PM
0230 bool "Enable extra state checking for runtime PM"
0231 depends on DRM_I915
0232 default n
0233 select STACKDEPOT
0234 help
0235 Choose this option to turn on extra state checking for the
0236 runtime PM functionality. This may introduce overhead during
0237 driver loading, suspend and resume operations.
0238
0239 Recommended for driver developers only.
0240
0241 If in doubt, say "N"
