[thirdparty/linux.git] / kernel / rcu / Kconfig.debug

# SPDX-License-Identifier: GPL-2.0-only
#
# RCU-related debugging configuration options
#

menu "RCU Debugging"

config PROVE_RCU
	def_bool PROVE_LOCKING

config PROVE_RCU_LIST
	bool "RCU list lockdep debugging"
	depends on PROVE_RCU && RCU_EXPERT
	default n
	help
	  Enable RCU lockdep checking for list usages. By default it is
	  turned off since there are several list RCU users that still
	  need to be converted to pass a lockdep expression. To prevent
	  false-positive splats, we keep it default disabled but once all
	  users are converted, we can remove this config option.

config TORTURE_TEST
	tristate
	default n

config RCU_PERF_TEST
	tristate "performance tests for RCU"
	depends on DEBUG_KERNEL
	select TORTURE_TEST
	select SRCU
	select TASKS_RCU
	default n
	help
	  This option provides a kernel module that runs performance
	  tests on the RCU infrastructure.  The kernel module may be built
	  after the fact on the running kernel to be tested, if desired.

	  Say Y here if you want RCU performance tests to be built into
	  the kernel.
	  Say M if you want the RCU performance tests to build as a module.
	  Say N if you are unsure.

config RCU_TORTURE_TEST
	tristate "torture tests for RCU"
	depends on DEBUG_KERNEL
	select TORTURE_TEST
	select SRCU
	select TASKS_RCU
	default n
	help
	  This option provides a kernel module that runs torture tests
	  on the RCU infrastructure.  The kernel module may be built
	  after the fact on the running kernel to be tested, if desired.

	  Say Y here if you want RCU torture tests to be built into
	  the kernel.
	  Say M if you want the RCU torture tests to build as a module.
	  Say N if you are unsure.

config RCU_CPU_STALL_TIMEOUT
	int "RCU CPU stall timeout in seconds"
	depends on RCU_STALL_COMMON
	range 3 300
	default 21
	help
	  If a given RCU grace period extends more than the specified
	  number of seconds, a CPU stall warning is printed.  If the
	  RCU grace period persists, additional CPU stall warnings are
	  printed at more widely spaced intervals.

config RCU_TRACE
	bool "Enable tracing for RCU"
	depends on DEBUG_KERNEL
	default y if TREE_RCU
	select TRACE_CLOCK
	help
	  This option enables additional tracepoints for ftrace-style
	  event tracing.

	  Say Y here if you want to enable RCU tracing
	  Say N if you are unsure.

config RCU_EQS_DEBUG
	bool "Provide debugging asserts for adding NO_HZ support to an arch"
	depends on DEBUG_KERNEL
	help
	  This option provides consistency checks in RCU's handling of
	  NO_HZ.  These checks have proven quite helpful in detecting
	  bugs in arch-specific NO_HZ code.

	  Say N here if you need ultimate kernel/user switch latencies
	  Say Y if you are unsure

endmenu # "RCU Debugging"
Commit	Line	Data
ec8f24b7	1	# SPDX-License-Identifier: GPL-2.0-only
43a0a2a7 PM	2	#
	3	# RCU-related debugging configuration options
	4	#
	5
	6	menu "RCU Debugging"
	7
	8	config PROVE_RCU
	9	def_bool PROVE_LOCKING
	10
28875945 JFG	11	config PROVE_RCU_LIST
	12	bool "RCU list lockdep debugging"
	13	depends on PROVE_RCU && RCU_EXPERT
	14	default n
	15	help
	16	Enable RCU lockdep checking for list usages. By default it is
	17	turned off since there are several list RCU users that still
	18	need to be converted to pass a lockdep expression. To prevent
	19	false-positive splats, we keep it default disabled but once all
	20	users are converted, we can remove this config option.
	21
43a0a2a7 PM	22	config TORTURE_TEST
	23	tristate
	24	default n
	25
	26	config RCU_PERF_TEST
	27	tristate "performance tests for RCU"
	28	depends on DEBUG_KERNEL
	29	select TORTURE_TEST
	30	select SRCU
	31	select TASKS_RCU
	32	default n
	33	help
	34	This option provides a kernel module that runs performance
	35	tests on the RCU infrastructure. The kernel module may be built
	36	after the fact on the running kernel to be tested, if desired.
	37
	38	Say Y here if you want RCU performance tests to be built into
	39	the kernel.
	40	Say M if you want the RCU performance tests to build as a module.
	41	Say N if you are unsure.
	42
	43	config RCU_TORTURE_TEST
	44	tristate "torture tests for RCU"
	45	depends on DEBUG_KERNEL
	46	select TORTURE_TEST
	47	select SRCU
	48	select TASKS_RCU
	49	default n
	50	help
	51	This option provides a kernel module that runs torture tests
	52	on the RCU infrastructure. The kernel module may be built
	53	after the fact on the running kernel to be tested, if desired.
	54
	55	Say Y here if you want RCU torture tests to be built into
	56	the kernel.
	57	Say M if you want the RCU torture tests to build as a module.
	58	Say N if you are unsure.
	59
	60	config RCU_CPU_STALL_TIMEOUT
	61	int "RCU CPU stall timeout in seconds"
	62	depends on RCU_STALL_COMMON
	63	range 3 300
	64	default 21
	65	help
	66	If a given RCU grace period extends more than the specified
	67	number of seconds, a CPU stall warning is printed. If the
	68	RCU grace period persists, additional CPU stall warnings are
	69	printed at more widely spaced intervals.
	70
	71	config RCU_TRACE
	72	bool "Enable tracing for RCU"
	73	depends on DEBUG_KERNEL
	74	default y if TREE_RCU
	75	select TRACE_CLOCK
	76	help
	77	This option enables additional tracepoints for ftrace-style
	78	event tracing.
	79
	80	Say Y here if you want to enable RCU tracing
	81	Say N if you are unsure.
	82
	83	config RCU_EQS_DEBUG
	84	bool "Provide debugging asserts for adding NO_HZ support to an arch"
	85	depends on DEBUG_KERNEL
86	help
87	This option provides consistency checks in RCU's handling of
88	NO_HZ. These checks have proven quite helpful in detecting
89	bugs in arch-specific NO_HZ code.
90
91	Say N here if you need ultimate kernel/user switch latencies
92	Say Y if you are unsure
93
94	endmenu # "RCU Debugging"