279 lines
		
	
	
		
			8.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			279 lines
		
	
	
		
			8.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| # SPDX-License-Identifier: GPL-2.0-only
 | |
| config DRM_I915_WERROR
 | |
| 	bool "Force GCC to throw an error instead of a warning when compiling"
 | |
| 	# As this may inadvertently break the build, only allow the user
 | |
| 	# to shoot oneself in the foot iff they aim really hard
 | |
| 	depends on EXPERT
 | |
| 	# We use the dependency on !COMPILE_TEST to not be enabled in
 | |
| 	# allmodconfig or allyesconfig configurations
 | |
| 	depends on !COMPILE_TEST
 | |
| 	default n
 | |
| 	help
 | |
| 	  Add -Werror to the build flags for (and only for) i915.ko.
 | |
| 	  Do not enable this unless you are writing code for the i915.ko module.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_REPLAY_GPU_HANGS_API
 | |
| 	bool "Enable GPU hang replay userspace API"
 | |
| 	depends on DRM_I915
 | |
| 	depends on EXPERT
 | |
| 	default n
 | |
| 	help
 | |
| 	  Choose this option if you want to enable special and unstable
 | |
| 	  userspace API used for replaying GPU hangs on a running system.
 | |
| 
 | |
| 	  This API is intended to be used by userspace graphics stack developers
 | |
| 	  and provides no stability guarantees.
 | |
| 
 | |
| 	  The API needs to be activated at boot time using the
 | |
| 	  enable_debug_only_api module parameter.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_DEBUG
 | |
| 	bool "Enable additional driver debugging"
 | |
| 	depends on DRM_I915
 | |
| 	depends on EXPERT # only for developers
 | |
| 	depends on !COMPILE_TEST # never built by robots
 | |
| 	select DEBUG_FS
 | |
| 	select PREEMPT_COUNT
 | |
| 	select I2C_CHARDEV
 | |
| 	select REF_TRACKER
 | |
| 	select STACKDEPOT
 | |
| 	select STACKTRACE
 | |
| 	select DRM_DISPLAY_DP_AUX_CHARDEV
 | |
| 	select DRM_DISPLAY_DP_TUNNEL_STATE_DEBUG if DRM_I915_DP_TUNNEL
 | |
| 	select X86_MSR # used by igt/pm_rpm
 | |
| 	select DRM_VGEM # used by igt/prime_vgem (dmabuf interop checks)
 | |
| 	select DRM_DEBUG_MM if DRM=y
 | |
| 	select DRM_EXPORT_FOR_TESTS if m
 | |
| 	select DRM_DEBUG_SELFTEST
 | |
| 	select DMABUF_SELFTESTS
 | |
| 	select SW_SYNC # signaling validation framework (igt/syncobj*)
 | |
| 	select DRM_I915_WERROR
 | |
| 	select DRM_I915_DEBUG_GEM
 | |
| 	select DRM_I915_DEBUG_GEM_ONCE
 | |
| 	select DRM_I915_DEBUG_MMIO
 | |
| 	select DRM_I915_DEBUG_RUNTIME_PM
 | |
| 	select DRM_I915_DEBUG_WAKEREF
 | |
| 	select DRM_I915_SW_FENCE_DEBUG_OBJECTS
 | |
| 	select DRM_I915_SELFTEST
 | |
| 	default n
 | |
| 	help
 | |
| 	  Choose this option to turn on extra driver debugging that may affect
 | |
| 	  performance but will catch some internal issues.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_DEBUG_MMIO
 | |
| 	bool "Always insert extra checks around mmio access by default"
 | |
| 	default n
 | |
| 	help
 | |
| 	  By default, always enables the extra sanity checks (extra register
 | |
| 	  reads) around every mmio (register) access that will slow the system
 | |
| 	  down. This sets the default value of i915.mmio_debug to -1 and can
 | |
| 	  be overridden at module load.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_DEBUG_GEM
 | |
| 	bool "Insert extra checks into the GEM internals"
 | |
| 	default n
 | |
| 	depends on DRM_I915_WERROR
 | |
| 	help
 | |
| 	  Enable extra sanity checks (including BUGs) along the GEM driver
 | |
| 	  paths that may slow the system down and if hit hang the machine.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_DEBUG_GEM_ONCE
 | |
| 	bool "Make a GEM debug failure fatal"
 | |
| 	default n
 | |
| 	depends on DRM_I915_DEBUG_GEM
 | |
| 	help
 | |
| 	  During development, we often only want the very first failure
 | |
| 	  as that would otherwise be lost in the deluge of subsequent
 | |
| 	  failures. However, more casual testers may not want to trigger
 | |
| 	  a hard BUG_ON and hope that the system remains sufficiently usable
 | |
| 	  to capture a bug report in situ.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_ERRLOG_GEM
 | |
| 	bool "Insert extra logging (very verbose) for common GEM errors"
 | |
| 	default n
 | |
| 	depends on DRM_I915_DEBUG_GEM
 | |
| 	help
 | |
| 	  Enable additional logging that may help track down the cause of
 | |
| 	  principally userspace errors.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_TRACE_GEM
 | |
| 	bool "Insert extra ftrace output from the GEM internals"
 | |
| 	depends on DRM_I915_DEBUG_GEM
 | |
| 	select TRACING
 | |
| 	default n
 | |
| 	help
 | |
| 	  Enable additional and verbose debugging output that will spam
 | |
| 	  ordinary tests, but may be vital for post-mortem debugging when
 | |
| 	  used with /proc/sys/kernel/ftrace_dump_on_oops
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_TRACE_GTT
 | |
| 	bool "Insert extra ftrace output from the GTT internals"
 | |
| 	depends on DRM_I915_DEBUG_GEM
 | |
| 	select TRACING
 | |
| 	default n
 | |
| 	help
 | |
| 	  Enable additional and verbose debugging output that will spam
 | |
| 	  ordinary tests, but may be vital for post-mortem debugging when
 | |
| 	  used with /proc/sys/kernel/ftrace_dump_on_oops
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_SW_FENCE_DEBUG_OBJECTS
 | |
| 	bool "Enable additional driver debugging for fence objects"
 | |
| 	depends on DRM_I915
 | |
| 	select DEBUG_OBJECTS
 | |
| 	default n
 | |
| 	help
 | |
| 	  Choose this option to turn on extra driver debugging that may affect
 | |
| 	  performance but will catch some internal issues.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_SW_FENCE_CHECK_DAG
 | |
| 	bool "Enable additional driver debugging for detecting dependency cycles"
 | |
| 	depends on DRM_I915
 | |
| 	default n
 | |
| 	help
 | |
| 	  Choose this option to turn on extra driver debugging that may affect
 | |
| 	  performance but will catch some internal issues.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_DEBUG_GUC
 | |
| 	bool "Enable additional driver debugging for GuC"
 | |
| 	depends on DRM_I915
 | |
| 	select STACKDEPOT
 | |
| 	default n
 | |
| 	help
 | |
| 	  Choose this option to turn on extra driver debugging that may affect
 | |
| 	  performance but will help resolve GuC related issues.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_SELFTEST
 | |
| 	bool "Enable selftests upon driver load"
 | |
| 	depends on DRM_I915
 | |
| 	default n
 | |
| 	select DRM_EXPORT_FOR_TESTS if m
 | |
| 	select FAULT_INJECTION
 | |
| 	select PRIME_NUMBERS
 | |
| 	select CRC32
 | |
| 	help
 | |
| 	  Choose this option to allow the driver to perform selftests upon
 | |
| 	  loading; also requires the i915.selftest=1 module parameter. To
 | |
| 	  exit the module after running the selftests (i.e. to prevent normal
 | |
| 	  module initialisation afterwards) use i915.selftest=-1.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_SELFTEST_BROKEN
 | |
| 	bool "Enable broken and dangerous selftests"
 | |
| 	depends on DRM_I915_SELFTEST
 | |
| 	depends on BROKEN
 | |
| 	default n
 | |
| 	help
 | |
| 	  This option enables the execution of selftests that are "dangerous"
 | |
| 	  and may trigger unintended HW side-effects as they break strict
 | |
| 	  rules given in the HW specification. For science.
 | |
| 
 | |
| 	  Recommended for masochistic driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_LOW_LEVEL_TRACEPOINTS
 | |
| 	bool "Enable low level request tracing events"
 | |
| 	depends on DRM_I915
 | |
| 	default n
 | |
| 	help
 | |
| 	  Choose this option to turn on low level request tracing events.
 | |
| 	  This provides the ability to precisely monitor engine utilisation
 | |
| 	  and also analyze the request dependency resolving timeline.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_DEBUG_VBLANK_EVADE
 | |
| 	bool "Enable extra debug warnings for vblank evasion"
 | |
| 	depends on DRM_I915
 | |
| 	default n
 | |
| 	help
 | |
| 	  Choose this option to turn on extra debug warnings for the
 | |
| 	  vblank evade mechanism. This gives a warning every time the
 | |
| 	  the deadline allotted for the vblank evade critical section
 | |
| 	  is exceeded, even if there isn't an actual risk of missing
 | |
| 	  the vblank.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N".
 | |
| 
 | |
| config DRM_I915_DEBUG_RUNTIME_PM
 | |
| 	bool "Enable extra state checking for runtime PM"
 | |
| 	depends on DRM_I915
 | |
| 	default n
 | |
| 	select REF_TRACKER
 | |
| 	select STACKDEPOT
 | |
| 	select STACKTRACE
 | |
| 	help
 | |
| 	  Choose this option to turn on extra state checking for the
 | |
| 	  runtime PM functionality. This may introduce overhead during
 | |
| 	  driver loading, suspend and resume operations.
 | |
| 
 | |
| 	  Recommended for driver developers only.
 | |
| 
 | |
| 	  If in doubt, say "N"
 | |
| 
 | |
| config DRM_I915_DEBUG_WAKEREF
 | |
| 	bool "Enable extra tracking for wakerefs"
 | |
| 	depends on DRM_I915
 | |
| 	select REF_TRACKER
 | |
| 	select STACKDEPOT
 | |
| 	select STACKTRACE
 | |
| 	help
 | |
| 	  Choose this option to turn on extra state checking and usage
 | |
| 	  tracking for the wakerefPM functionality. This may introduce
 | |
| 	  overhead during driver runtime.
 | |
| 
 | |
| 	  If in doubt, say "N"
 |