1 # SPDX-License-Identifier: GPL-2.0-only
2 #
3 # RCU-related debugging configuration options
4 #
5
6 menu "RCU Debugging"
7
8 config PROVE_RCU
9 def_bool PROVE_LOCKING
10
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
17 turned off since there are several l
18 need to be converted to pass a lockd
19 false-positive splats, we keep it de
20 users are converted, we can remove t
21
22 config TORTURE_TEST
23 tristate
24 default n
25
26 config RCU_SCALE_TEST
27 tristate "performance tests for RCU"
28 depends on DEBUG_KERNEL
29 select TORTURE_TEST
30 default n
31 help
32 This option provides a kernel module
33 tests on the RCU infrastructure. Th
34 after the fact on the running kernel
35
36 Say Y here if you want RCU performan
37 the kernel.
38 Say M if you want the RCU performanc
39 Say N if you are unsure.
40
41 config RCU_TORTURE_TEST
42 tristate "torture tests for RCU"
43 depends on DEBUG_KERNEL
44 select TORTURE_TEST
45 default n
46 help
47 This option provides a kernel module
48 on the RCU infrastructure. The kern
49 after the fact on the running kernel
50
51 Say Y here if you want RCU torture t
52 the kernel.
53 Say M if you want the RCU torture te
54 Say N if you are unsure.
55
56 config RCU_REF_SCALE_TEST
57 tristate "Scalability tests for read-s
58 depends on DEBUG_KERNEL
59 select TORTURE_TEST
60 default n
61 help
62 This option provides a kernel module
63 useful comparing RCU with various re
64 The kernel module may be built after
65 tested, if desired.
66
67 Say Y here if you want these perform
68 Say M if you want to build it as a m
69 Say N if you are unsure.
70
71 config RCU_CPU_STALL_TIMEOUT
72 int "RCU CPU stall timeout in seconds"
73 depends on RCU_STALL_COMMON
74 range 3 300
75 default 21
76 help
77 If a given RCU grace period extends
78 number of seconds, a CPU stall warni
79 RCU grace period persists, additiona
80 printed at more widely spaced interv
81
82 config RCU_EXP_CPU_STALL_TIMEOUT
83 int "Expedited RCU CPU stall timeout i
84 depends on RCU_STALL_COMMON
85 range 0 300000
86 default 0
87 help
88 If a given expedited RCU grace perio
89 specified number of milliseconds, a
90 If the RCU grace period persists, ad
91 are printed at more widely spaced in
92 says to use the RCU_CPU_STALL_TIMEOU
93 seconds to milliseconds.
94
95 config RCU_CPU_STALL_CPUTIME
96 bool "Provide additional RCU stall deb
97 depends on RCU_STALL_COMMON
98 default n
99 help
100 Collect statistics during the sampli
101 (hard interrupts, soft interrupts, t
102 (hard interrupts, soft interrupts, k
103 RCU stall report. For multiple conti
104 periods begin at half of the first R
105 The boot option rcupdate.rcu_cpu_sta
106 as this one, but will override this
107
108 config RCU_CPU_STALL_NOTIFIER
109 bool "Provide RCU CPU-stall notifiers"
110 depends on RCU_STALL_COMMON
111 depends on DEBUG_KERNEL
112 depends on RCU_EXPERT
113 default n
114 help
115 WARNING: You almost certainly do no
116
117 Enable RCU CPU-stall notifiers, whic
118 printing the RCU CPU stall warning.
119 callbacks can prevent stall warnings
120 And the whole reason that a stall wa
121 that something is hung up somewhere.
122 callbacks must be written extremely
123 containing only lockless code. Afte
124 that the whole reason that the RCU C
125 the first place is that someone forg
126 that you are thinking of acquiring.
127 notifier callback acquire that lock
128 RCU CPU stall warning from appearing
129
130 Say Y here if you want RCU CPU stall
131 Say N if you are unsure.
132
133 config RCU_TRACE
134 bool "Enable tracing for RCU"
135 depends on DEBUG_KERNEL
136 default y if TREE_RCU
137 select TRACE_CLOCK
138 help
139 This option enables additional trace
140 event tracing.
141
142 Say Y here if you want to enable RCU
143 Say N if you are unsure.
144
145 config RCU_EQS_DEBUG
146 bool "Provide debugging asserts for ad
147 depends on DEBUG_KERNEL
148 help
149 This option provides consistency che
150 NO_HZ. These checks have proven qui
151 bugs in arch-specific NO_HZ code.
152
153 Say N here if you need ultimate kern
154 Say Y if you are unsure
155
156 config RCU_STRICT_GRACE_PERIOD
157 bool "Provide debug RCU implementation
158 depends on DEBUG_KERNEL && RCU_EXPERT
159 default n
160 select PREEMPT_COUNT if PREEMPT=n
161 help
162 Select this option to build an RCU v
163 grace periods, making them as short
164 scalability, destroys real-time resp
165 lifetime and kills performance. Don
166 machines, as in systems with more th
167 But in conjunction with tools like K
168 when looking for certain types of RC
169 too-short RCU read-side critical sec
170
171 endmenu # "RCU Debugging"
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.