mips, bpf: Fix reference to non-existing Kconfig symbol
[linux-block.git] / lib / Kconfig.debug
CommitLineData
ec8f24b7 1# SPDX-License-Identifier: GPL-2.0-only
06ec64b8
CH
2menu "Kernel hacking"
3
604ff0dc 4menu "printk and dmesg options"
1da177e4
LT
5
6config PRINTK_TIME
7 bool "Show timing information on printks"
d3b8b6e5 8 depends on PRINTK
1da177e4 9 help
649e6ee3
KS
10 Selecting this option causes time stamps of the printk()
11 messages to be added to the output of the syslog() system
12 call and at the console.
13
14 The timestamp is always recorded internally, and exported
15 to /dev/kmsg. This flag just specifies if the timestamp should
16 be included, not that the timestamp is recorded.
17
18 The behavior is also controlled by the kernel command line
8c27ceff 19 parameter printk.time=1. See Documentation/admin-guide/kernel-parameters.rst
1da177e4 20
15ff2069
TH
21config PRINTK_CALLER
22 bool "Show caller information on printks"
23 depends on PRINTK
24 help
25 Selecting this option causes printk() to add a caller "thread id" (if
26 in task context) or a caller "processor id" (if not in task context)
27 to every message.
28
29 This option is intended for environments where multiple threads
30 concurrently call printk() for many times, for it is difficult to
31 interpret without knowing where these lines (or sometimes individual
32 line which was divided into multiple lines due to race) came from.
33
34 Since toggling after boot makes the code racy, currently there is
35 no option to enable/disable at the kernel command line parameter or
36 sysfs interface.
37
22f4e66d
SB
38config STACKTRACE_BUILD_ID
39 bool "Show build ID information in stacktraces"
40 depends on PRINTK
41 help
42 Selecting this option adds build ID information for symbols in
43 stacktraces printed with the printk format '%p[SR]b'.
44
45 This option is intended for distros where debuginfo is not easily
46 accessible but can be downloaded given the build ID of the vmlinux or
47 kernel module where the function is located.
48
a8cfdc68
OJ
49config CONSOLE_LOGLEVEL_DEFAULT
50 int "Default console loglevel (1-15)"
51 range 1 15
52 default "7"
53 help
54 Default loglevel to determine what will be printed on the console.
55
56 Setting a default here is equivalent to passing in loglevel=<x> in
57 the kernel bootargs. loglevel=<x> continues to override whatever
58 value is specified here as well.
59
50f4d9bd 60 Note: This does not affect the log level of un-prefixed printk()
a8cfdc68
OJ
61 usage in the kernel. That is controlled by the MESSAGE_LOGLEVEL_DEFAULT
62 option.
63
22eceb8b
HG
64config CONSOLE_LOGLEVEL_QUIET
65 int "quiet console loglevel (1-15)"
66 range 1 15
67 default "4"
68 help
69 loglevel to use when "quiet" is passed on the kernel commandline.
70
71 When "quiet" is passed on the kernel commandline this loglevel
72 will be used as the loglevel. IOW passing "quiet" will be the
73 equivalent of passing "loglevel=<CONSOLE_LOGLEVEL_QUIET>"
74
42a9dc0b 75config MESSAGE_LOGLEVEL_DEFAULT
5af5bcb8
MSB
76 int "Default message log level (1-7)"
77 range 1 7
78 default "4"
79 help
80 Default log level for printk statements with no specified priority.
81
82 This was hard-coded to KERN_WARNING since at least 2.6.10 but folks
83 that are auditing their logs closely may want to set it to a lower
84 priority.
85
a8cfdc68
OJ
86 Note: This does not affect what message level gets printed on the console
87 by default. To change that, use loglevel=<x> in the kernel bootargs,
88 or pick a different CONSOLE_LOGLEVEL_DEFAULT configuration value.
89
604ff0dc
DH
90config BOOT_PRINTK_DELAY
91 bool "Delay each boot printk message by N milliseconds"
92 depends on DEBUG_KERNEL && PRINTK && GENERIC_CALIBRATE_DELAY
93 help
94 This build option allows you to read kernel boot messages
95 by inserting a short delay after each one. The delay is
96 specified in milliseconds on the kernel command line,
97 using "boot_delay=N".
98
99 It is likely that you would also need to use "lpj=M" to preset
100 the "loops per jiffie" value.
101 See a previous boot log for the "lpj" value to use for your
102 system, and then set "lpj=M" before setting "boot_delay=N".
103 NOTE: Using this option may adversely affect SMP systems.
104 I.e., processors other than the first one may not boot up.
105 BOOT_PRINTK_DELAY also may cause LOCKUP_DETECTOR to detect
106 what it believes to be lockup conditions.
107
108config DYNAMIC_DEBUG
109 bool "Enable dynamic printk() support"
110 default n
111 depends on PRINTK
239a5791 112 depends on (DEBUG_FS || PROC_FS)
ceabef7d 113 select DYNAMIC_DEBUG_CORE
604ff0dc
DH
114 help
115
116 Compiles debug level messages into the kernel, which would not
117 otherwise be available at runtime. These messages can then be
118 enabled/disabled based on various levels of scope - per source file,
119 function, module, format string, and line number. This mechanism
120 implicitly compiles in all pr_debug() and dev_dbg() calls, which
121 enlarges the kernel text size by about 2%.
122
123 If a source file is compiled with DEBUG flag set, any
124 pr_debug() calls in it are enabled by default, but can be
125 disabled at runtime as below. Note that DEBUG flag is
126 turned on by many CONFIG_*DEBUG* options.
127
128 Usage:
129
130 Dynamic debugging is controlled via the 'dynamic_debug/control' file,
239a5791
GKH
131 which is contained in the 'debugfs' filesystem or procfs.
132 Thus, the debugfs or procfs filesystem must first be mounted before
133 making use of this feature.
604ff0dc
DH
134 We refer the control file as: <debugfs>/dynamic_debug/control. This
135 file contains a list of the debug statements that can be enabled. The
136 format for each line of the file is:
137
138 filename:lineno [module]function flags format
139
140 filename : source file of the debug statement
141 lineno : line number of the debug statement
142 module : module that contains the debug statement
143 function : function that contains the debug statement
68d4b3df
KK
144 flags : '=p' means the line is turned 'on' for printing
145 format : the format used for the debug statement
604ff0dc
DH
146
147 From a live system:
148
149 nullarbor:~ # cat <debugfs>/dynamic_debug/control
150 # filename:lineno [module]function flags format
151 fs/aio.c:222 [aio]__put_ioctx =_ "__put_ioctx:\040freeing\040%p\012"
152 fs/aio.c:248 [aio]ioctx_alloc =_ "ENOMEM:\040nr_events\040too\040high\012"
153 fs/aio.c:1770 [aio]sys_io_cancel =_ "calling\040cancel\012"
154
155 Example usage:
156
157 // enable the message at line 1603 of file svcsock.c
158 nullarbor:~ # echo -n 'file svcsock.c line 1603 +p' >
159 <debugfs>/dynamic_debug/control
160
161 // enable all the messages in file svcsock.c
162 nullarbor:~ # echo -n 'file svcsock.c +p' >
163 <debugfs>/dynamic_debug/control
164
165 // enable all the messages in the NFS server module
166 nullarbor:~ # echo -n 'module nfsd +p' >
167 <debugfs>/dynamic_debug/control
168
169 // enable all 12 messages in the function svc_process()
170 nullarbor:~ # echo -n 'func svc_process +p' >
171 <debugfs>/dynamic_debug/control
172
173 // disable all 12 messages in the function svc_process()
174 nullarbor:~ # echo -n 'func svc_process -p' >
175 <debugfs>/dynamic_debug/control
176
f8998c22
HH
177 See Documentation/admin-guide/dynamic-debug-howto.rst for additional
178 information.
604ff0dc 179
ceabef7d
OZ
180config DYNAMIC_DEBUG_CORE
181 bool "Enable core function of dynamic debug support"
182 depends on PRINTK
183 depends on (DEBUG_FS || PROC_FS)
184 help
185 Enable core functional support of dynamic debug. It is useful
186 when you want to tie dynamic debug to your kernel modules with
187 DYNAMIC_DEBUG_MODULE defined for each of them, especially for
188 the case of embedded system where the kernel image size is
189 sensitive for people.
190
57f5677e
RV
191config SYMBOLIC_ERRNAME
192 bool "Support symbolic error names in printf"
193 default y if PRINTK
194 help
195 If you say Y here, the kernel's printf implementation will
196 be able to print symbolic error names such as ENOSPC instead
197 of the number 28. It makes the kernel image slightly larger
198 (about 3KB), but can make the kernel logs easier to read.
199
2b05bb75
CD
200config DEBUG_BUGVERBOSE
201 bool "Verbose BUG() reporting (adds 70K)" if DEBUG_KERNEL && EXPERT
202 depends on BUG && (GENERIC_BUG || HAVE_DEBUG_BUGVERBOSE)
203 default y
204 help
205 Say Y here to make BUG() panics output the file name and line number
206 of the BUG call as well as the EIP and oops trace. This aids
207 debugging but costs about 70-100K of memory.
208
604ff0dc
DH
209endmenu # "printk and dmesg options"
210
6dfc0665
DH
211menu "Compile-time checks and compiler options"
212
213config DEBUG_INFO
214 bool "Compile the kernel with debug info"
12b13835 215 depends on DEBUG_KERNEL && !COMPILE_TEST
6dfc0665 216 help
68d4b3df 217 If you say Y here the resulting kernel image will include
6dfc0665
DH
218 debugging info resulting in a larger kernel image.
219 This adds debug symbols to the kernel and modules (gcc -g), and
220 is needed if you intend to use kernel crashdump or binary object
221 tools like crash, kgdb, LKCD, gdb, etc on the kernel.
222 Say Y here only if you plan to debug the kernel.
223
224 If unsure, say N.
225
695afd3d
SD
226if DEBUG_INFO
227
6dfc0665
DH
228config DEBUG_INFO_REDUCED
229 bool "Reduce debugging information"
6dfc0665
DH
230 help
231 If you say Y here gcc is instructed to generate less debugging
232 information for structure types. This means that tools that
233 need full debugging information (like kgdb or systemtap) won't
234 be happy. But if you merely need debugging information to
235 resolve line numbers there is no loss. Advantage is that
236 build directory object sizes shrink dramatically over a full
237 DEBUG_INFO build and compile times are reduced too.
238 Only works with newer gcc versions.
239
10e68b02
ND
240config DEBUG_INFO_COMPRESSED
241 bool "Compressed debugging information"
10e68b02 242 depends on $(cc-option,-gz=zlib)
10e68b02
ND
243 depends on $(ld-option,--compress-debug-sections=zlib)
244 help
245 Compress the debug information using zlib. Requires GCC 5.0+ or Clang
246 5.0+, binutils 2.26+, and zlib.
247
248 Users of dpkg-deb via scripts/package/builddeb may find an increase in
249 size of their debug .deb packages with this config set, due to the
250 debug info being compressed with zlib, then the object files being
251 recompressed with a different compression scheme. But this is still
252 preferable to setting $KDEB_COMPRESS to "none" which would be even
253 larger.
254
866ced95
AK
255config DEBUG_INFO_SPLIT
256 bool "Produce split debuginfo in .dwo files"
9d937444 257 depends on $(cc-option,-gsplit-dwarf)
866ced95
AK
258 help
259 Generate debug info into separate .dwo files. This significantly
260 reduces the build directory size for builds with DEBUG_INFO,
261 because it stores the information only once on disk in .dwo
262 files instead of multiple times in object files and executables.
263 In addition the debug information is also compressed.
264
265 Requires recent gcc (4.7+) and recent gdb/binutils.
266 Any tool that packages or reads debug information would need
267 to know about the .dwo files and include them.
268 Incompatible with older versions of ccache.
269
a66049e2
ND
270choice
271 prompt "DWARF version"
272 help
273 Which version of DWARF debug info to emit.
274
275config DEBUG_INFO_DWARF_TOOLCHAIN_DEFAULT
276 bool "Rely on the toolchain's implicit default DWARF version"
277 help
278 The implicit default version of DWARF debug info produced by a
279 toolchain changes over time.
280
281 This can break consumers of the debug info that haven't upgraded to
282 support newer revisions, and prevent testing newer versions, but
283 those should be less common scenarios.
284
285 If unsure, say Y.
286
bfaf2dd3 287config DEBUG_INFO_DWARF4
a66049e2 288 bool "Generate DWARF Version 4 debuginfo"
bfaf2dd3 289 help
a66049e2
ND
290 Generate DWARF v4 debug info. This requires gcc 4.5+ and gdb 7.0+.
291
292 If you have consumers of DWARF debug info that are not ready for
293 newer revisions of DWARF, you may wish to choose this or have your
294 config select this.
295
98cd6f52
ND
296config DEBUG_INFO_DWARF5
297 bool "Generate DWARF Version 5 debuginfo"
c0a5c81c 298 depends on !CC_IS_CLANG || (CC_IS_CLANG && (AS_IS_LLVM || (AS_IS_GNU && AS_VERSION >= 23502)))
98cd6f52 299 depends on !DEBUG_INFO_BTF
bfaf2dd3 300 help
98cd6f52
ND
301 Generate DWARF v5 debug info. Requires binutils 2.35.2, gcc 5.0+ (gcc
302 5.0+ accepts the -gdwarf-5 flag but only had partial support for some
303 draft features until 7.0), and gdb 8.0+.
304
305 Changes to the structure of debug info in Version 5 allow for around
306 15-18% savings in resulting image and debug info section sizes as
307 compared to DWARF Version 4. DWARF Version 5 standardizes previous
308 extensions such as accelerators for symbol indexing and the format
309 for fission (.dwo/.dwp) files. Users may not want to select this
310 config if they rely on tooling that has not yet been updated to
311 support DWARF Version 5.
312
a66049e2 313endchoice # "DWARF version"
bfaf2dd3 314
e83b9f55
AN
315config DEBUG_INFO_BTF
316 bool "Generate BTF typeinfo"
7d32e693
SB
317 depends on !DEBUG_INFO_SPLIT && !DEBUG_INFO_REDUCED
318 depends on !GCC_PLUGIN_RANDSTRUCT || COMPILE_TEST
e83b9f55
AN
319 help
320 Generate deduplicated BTF type information from DWARF debug info.
321 Turning this on expects presence of pahole tool, which will convert
322 DWARF type info into equivalent deduplicated BTF type info.
323
5f9ae91f
AN
324config PAHOLE_HAS_SPLIT_BTF
325 def_bool $(success, test `$(PAHOLE) --version | sed -E 's/v([0-9]+)\.([0-9]+)/\1\2/'` -ge "119")
326
327config DEBUG_INFO_BTF_MODULES
328 def_bool y
329 depends on DEBUG_INFO_BTF && MODULES && PAHOLE_HAS_SPLIT_BTF
330 help
331 Generate compact split BTF type information for kernel modules.
332
3ee7b3fa
JK
333config GDB_SCRIPTS
334 bool "Provide GDB scripts for kernel debugging"
3ee7b3fa
JK
335 help
336 This creates the required links to GDB helper scripts in the
337 build directory. If you load vmlinux into gdb, the helper
338 scripts will be automatically imported by gdb as well, and
339 additional functions are available to analyze a Linux kernel
700199b0
AP
340 instance. See Documentation/dev-tools/gdb-kernel-debugging.rst
341 for further details.
3ee7b3fa 342
695afd3d
SD
343endif # DEBUG_INFO
344
35bb5b1e 345config FRAME_WARN
a83e4ca2 346 int "Warn for stack frames larger than"
35bb5b1e 347 range 0 8192
0e07f663 348 default 2048 if GCC_PLUGIN_LATENT_ENTROPY
86705024 349 default 1536 if (!64BIT && (PARISC || XTENSA))
432654df 350 default 1024 if (!64BIT && !PARISC)
35bb5b1e
AK
351 default 2048 if 64BIT
352 help
353 Tell gcc to warn at build time for stack frames larger than this.
354 Setting this too low will cause a lot of warnings.
355 Setting it to 0 disables the warning.
35bb5b1e 356
99657c78
RD
357config STRIP_ASM_SYMS
358 bool "Strip assembler-generated symbols during link"
359 default n
360 help
361 Strip internal assembler-generated symbols during a link (symbols
362 that look like '.Lxxx') so they don't pollute the output of
363 get_wchan() and suchlike.
364
1873e870 365config READABLE_ASM
68d4b3df
KK
366 bool "Generate readable assembler code"
367 depends on DEBUG_KERNEL
7d73c3e9 368 depends on CC_IS_GCC
bf4735a4 369 help
68d4b3df
KK
370 Disable some compiler optimizations that tend to generate human unreadable
371 assembler output. This may make the kernel slightly slower, but it helps
372 to keep kernel developers who have to stare a lot at assembler listings
373 sane.
bf4735a4 374
e949f4c2
MY
375config HEADERS_INSTALL
376 bool "Install uapi headers to usr/include"
bf4735a4
DM
377 depends on !UML
378 help
e949f4c2
MY
379 This option will install uapi headers (headers exported to user-space)
380 into the usr/include directory for use during the kernel build.
381 This is unneeded for building the kernel itself, but needed for some
382 user-space program samples. It is also needed by some features such
383 as uapi header sanity checks.
384
91341d4b
SR
385config DEBUG_SECTION_MISMATCH
386 bool "Enable full Section mismatch analysis"
7d73c3e9 387 depends on CC_IS_GCC
91341d4b
SR
388 help
389 The section mismatch analysis checks if there are illegal
390 references from one section to another section.
e809ab01
MW
391 During linktime or runtime, some sections are dropped;
392 any use of code/data previously in these sections would
91341d4b 393 most likely result in an oops.
e809ab01 394 In the code, functions and variables are annotated with
0db0628d 395 __init,, etc. (see the full list in include/linux/init.h),
d6fbfa4f 396 which results in the code/data being placed in specific sections.
e809ab01
MW
397 The section mismatch analysis is always performed after a full
398 kernel build, and enabling this option causes the following
b7dca6dd 399 additional step to occur:
e809ab01
MW
400 - Add the option -fno-inline-functions-called-once to gcc commands.
401 When inlining a function annotated with __init in a non-init
402 function, we would lose the section information and thus
91341d4b 403 the analysis would not catch the illegal reference.
e809ab01
MW
404 This option tells gcc to inline less (but it does result in
405 a larger kernel).
91341d4b 406
47490ec1
NB
407config SECTION_MISMATCH_WARN_ONLY
408 bool "Make section mismatch errors non-fatal"
409 default y
410 help
411 If you say N here, the build process will fail if there are any
412 section mismatch, instead of just throwing warnings.
413
414 If unsure, say Y.
415
cf536e18
FT
416config DEBUG_FORCE_FUNCTION_ALIGN_64B
417 bool "Force all function address 64B aligned" if EXPERT
09c60546
FT
418 help
419 There are cases that a commit from one domain changes the function
420 address alignment of other domains, and cause magic performance
421 bump (regression or improvement). Enable this option will help to
422 verify if the bump is caused by function alignment changes, while
423 it will slightly increase the kernel size and affect icache usage.
424
425 It is mainly for debug and performance tuning use.
426
6dfc0665
DH
427#
428# Select this config option from the architecture Kconfig, if it
429# is preferred to always offer frame pointers as a config
430# option on the architecture (regardless of KERNEL_DEBUG):
431#
432config ARCH_WANT_FRAME_POINTERS
433 bool
f346f4b3 434
6dfc0665
DH
435config FRAME_POINTER
436 bool "Compile the kernel with frame pointers"
a687a533 437 depends on DEBUG_KERNEL && (M68K || UML || SUPERH) || ARCH_WANT_FRAME_POINTERS
6dfc0665 438 default y if (DEBUG_INFO && UML) || ARCH_WANT_FRAME_POINTERS
a304e1b8 439 help
6dfc0665
DH
440 If you say Y here the resulting kernel image will be slightly
441 larger and slower, but it gives very useful debugging information
442 in case of kernel bugs. (precise oopses/stacktraces/warnings)
a304e1b8 443
b9ab5ebb
JP
444config STACK_VALIDATION
445 bool "Compile-time stack metadata validation"
446 depends on HAVE_STACK_VALIDATION
447 default n
448 help
449 Add compile-time checks to validate stack metadata, including frame
450 pointers (if CONFIG_FRAME_POINTER is enabled). This helps ensure
451 that runtime stack traces are more reliable.
452
ee9f8fce 453 This is also a prerequisite for generation of ORC unwind data, which
11af8474 454 is needed for CONFIG_UNWINDER_ORC.
ee9f8fce 455
b9ab5ebb
JP
456 For more information, see
457 tools/objtool/Documentation/stack-validation.txt.
458
6804c1af
PZ
459config VMLINUX_VALIDATION
460 bool
db2b0c5d 461 depends on STACK_VALIDATION && DEBUG_ENTRY
6804c1af
PZ
462 default y
463
5cc12472
RV
464config VMLINUX_MAP
465 bool "Generate vmlinux.map file when linking"
466 depends on EXPERT
467 help
468 Selecting this option will pass "-Map=vmlinux.map" to ld
469 when linking vmlinux. That file can be useful for verifying
470 and debugging magic section games, and for seeing which
471 pieces of code get eliminated with
472 CONFIG_LD_DEAD_CODE_DATA_ELIMINATION.
473
6dfc0665
DH
474config DEBUG_FORCE_WEAK_PER_CPU
475 bool "Force weak per-cpu definitions"
476 depends on DEBUG_KERNEL
8446f1d3 477 help
6dfc0665
DH
478 s390 and alpha require percpu variables in modules to be
479 defined weak to work around addressing range issue which
480 puts the following two restrictions on percpu variable
481 definitions.
8446f1d3 482
6dfc0665
DH
483 1. percpu symbols must be unique whether static or not
484 2. percpu variables can't be defined inside a function
8446f1d3 485
6dfc0665
DH
486 To ensure that generic code follows the above rules, this
487 option forces all percpu variables to be defined as weak.
5f329089 488
6dfc0665 489endmenu # "Compiler options"
8446f1d3 490
6210b640
CD
491menu "Generic Kernel Debugging Instruments"
492
6dfc0665
DH
493config MAGIC_SYSRQ
494 bool "Magic SysRq key"
495 depends on !UML
496 help
497 If you say Y here, you will have some control over the system even
498 if the system crashes for example during kernel debugging (e.g., you
499 will be able to flush the buffer cache to disk, reboot the system
500 immediately or dump some status information). This is accomplished
501 by pressing various keys while holding SysRq (Alt+PrintScreen). It
502 also works on a serial console (on PC hardware at least), if you
503 send a BREAK and then within 5 seconds a command keypress. The
f8998c22
HH
504 keys are documented in <file:Documentation/admin-guide/sysrq.rst>.
505 Don't say Y unless you really know what this hack does.
8446f1d3 506
8eaede49
BH
507config MAGIC_SYSRQ_DEFAULT_ENABLE
508 hex "Enable magic SysRq key functions by default"
509 depends on MAGIC_SYSRQ
510 default 0x1
511 help
512 Specifies which SysRq key functions are enabled by default.
513 This may be set to 1 or 0 to enable or disable them all, or
f8998c22 514 to a bitmask as described in Documentation/admin-guide/sysrq.rst.
8eaede49 515
732dbf3a
FF
516config MAGIC_SYSRQ_SERIAL
517 bool "Enable magic SysRq key over serial"
518 depends on MAGIC_SYSRQ
519 default y
520 help
521 Many embedded boards have a disconnected TTL level serial which can
522 generate some garbage that can lead to spurious false sysrq detects.
523 This option allows you to decide whether you want to enable the
524 magic SysRq key.
525
68af4317
DS
526config MAGIC_SYSRQ_SERIAL_SEQUENCE
527 string "Char sequence that enables magic SysRq over serial"
528 depends on MAGIC_SYSRQ_SERIAL
529 default ""
530 help
531 Specifies a sequence of characters that can follow BREAK to enable
532 SysRq on a serial console.
533
d3394b3d
DS
534 If unsure, leave an empty string and the option will not be enabled.
535
ec29a5c1
CD
536config DEBUG_FS
537 bool "Debug Filesystem"
538 help
539 debugfs is a virtual file system that kernel developers use to put
540 debugging files into. Enable this option to be able to read and
541 write to these files.
542
543 For detailed documentation on the debugfs API, see
544 Documentation/filesystems/.
545
546 If unsure, say N.
547
a24c6f7b
PE
548choice
549 prompt "Debugfs default access"
550 depends on DEBUG_FS
551 default DEBUG_FS_ALLOW_ALL
552 help
553 This selects the default access restrictions for debugfs.
554 It can be overridden with kernel command line option
555 debugfs=[on,no-mount,off]. The restrictions apply for API access
556 and filesystem registration.
557
558config DEBUG_FS_ALLOW_ALL
559 bool "Access normal"
560 help
561 No restrictions apply. Both API and filesystem registration
562 is on. This is the normal default operation.
563
564config DEBUG_FS_DISALLOW_MOUNT
565 bool "Do not register debugfs as filesystem"
566 help
567 The API is open but filesystem is not loaded. Clients can still do
568 their work and read with debug tools that do not need
569 debugfs filesystem.
570
571config DEBUG_FS_ALLOW_NONE
572 bool "No access"
573 help
574 Access is off. Clients get -PERM when trying to create nodes in
575 debugfs tree and debugfs is not registered as a filesystem.
576 Client can then back-off or continue without debugfs access.
577
578endchoice
579
6210b640 580source "lib/Kconfig.kgdb"
6210b640 581source "lib/Kconfig.ubsan"
2645d432 582source "lib/Kconfig.kcsan"
6210b640
CD
583
584endmenu
585
f346f4b3
AB
586config DEBUG_KERNEL
587 bool "Kernel debugging"
fef2c9bc 588 help
f346f4b3
AB
589 Say Y here if you are developing drivers or trying to debug and
590 identify kernel problems.
fef2c9bc 591
c66d7a27
SK
592config DEBUG_MISC
593 bool "Miscellaneous debug code"
594 default DEBUG_KERNEL
595 depends on DEBUG_KERNEL
596 help
597 Say Y here if you need to enable miscellaneous debug code that should
598 be under a more specific debug option but isn't.
599
600
0610c8a8 601menu "Memory Debugging"
fef2c9bc 602
8636a1f9 603source "mm/Kconfig.debug"
fef2c9bc 604
0610c8a8
DH
605config DEBUG_OBJECTS
606 bool "Debug object operations"
607 depends on DEBUG_KERNEL
9c44bc03 608 help
0610c8a8
DH
609 If you say Y here, additional code will be inserted into the
610 kernel to track the life time of various objects and validate
611 the operations on those objects.
9c44bc03 612
0610c8a8
DH
613config DEBUG_OBJECTS_SELFTEST
614 bool "Debug objects selftest"
615 depends on DEBUG_OBJECTS
616 help
617 This enables the selftest of the object debug code.
9c44bc03 618
0610c8a8
DH
619config DEBUG_OBJECTS_FREE
620 bool "Debug objects in freed memory"
621 depends on DEBUG_OBJECTS
622 help
623 This enables checks whether a k/v free operation frees an area
624 which contains an object which has not been deactivated
625 properly. This can make kmalloc/kfree-intensive workloads
626 much slower.
3ac7fe5a 627
c6f3a97f
TG
628config DEBUG_OBJECTS_TIMERS
629 bool "Debug timer objects"
630 depends on DEBUG_OBJECTS
631 help
632 If you say Y here, additional code will be inserted into the
633 timer routines to track the life time of timer objects and
634 validate the timer operations.
635
dc186ad7
TG
636config DEBUG_OBJECTS_WORK
637 bool "Debug work objects"
638 depends on DEBUG_OBJECTS
639 help
640 If you say Y here, additional code will be inserted into the
641 work queue routines to track the life time of work objects and
642 validate the work operations.
643
551d55a9
MD
644config DEBUG_OBJECTS_RCU_HEAD
645 bool "Debug RCU callbacks objects"
fc2ecf7e 646 depends on DEBUG_OBJECTS
551d55a9
MD
647 help
648 Enable this to turn on debugging of RCU list heads (call_rcu() usage).
649
e2852ae8
TH
650config DEBUG_OBJECTS_PERCPU_COUNTER
651 bool "Debug percpu counter objects"
652 depends on DEBUG_OBJECTS
653 help
654 If you say Y here, additional code will be inserted into the
655 percpu counter routines to track the life time of percpu counter
656 objects and validate the percpu counter operations.
657
3ae70205
IM
658config DEBUG_OBJECTS_ENABLE_DEFAULT
659 int "debug_objects bootup default value (0-1)"
68d4b3df
KK
660 range 0 1
661 default "1"
662 depends on DEBUG_OBJECTS
663 help
664 Debug objects boot parameter default value
3ae70205 665
1da177e4 666config DEBUG_SLAB
4a2f0acf 667 bool "Debug slab memory allocations"
4675ff05 668 depends on DEBUG_KERNEL && SLAB
1da177e4
LT
669 help
670 Say Y here to have the kernel do limited verification on memory
671 allocation as well as poisoning memory on free to catch use of freed
672 memory. This can make kmalloc/kfree-intensive workloads much slower.
673
f0630fff
CL
674config SLUB_DEBUG_ON
675 bool "SLUB debugging on by default"
4675ff05 676 depends on SLUB && SLUB_DEBUG
f0630fff
CL
677 default n
678 help
679 Boot with debugging on by default. SLUB boots by default with
680 the runtime debug capabilities switched off. Enabling this is
681 equivalent to specifying the "slub_debug" parameter on boot.
682 There is no support for more fine grained debug control like
683 possible with slub_debug=xxx. SLUB debugging may be switched
684 off in a kernel built with CONFIG_SLUB_DEBUG_ON by specifying
685 "slub_debug=-".
686
8ff12cfc
CL
687config SLUB_STATS
688 default n
689 bool "Enable SLUB performance statistics"
ab4d5ed5 690 depends on SLUB && SYSFS
8ff12cfc
CL
691 help
692 SLUB statistics are useful to debug SLUBs allocation behavior in
693 order find ways to optimize the allocator. This should never be
694 enabled for production use since keeping statistics slows down
695 the allocator by a few percentage points. The slabinfo command
696 supports the determination of the most active slabs to figure
697 out which slabs are relevant to a particular load.
698 Try running: slabinfo -DA
699
b69ec42b
CM
700config HAVE_DEBUG_KMEMLEAK
701 bool
702
3bba00d7
CM
703config DEBUG_KMEMLEAK
704 bool "Kernel memory leak detector"
525c1f92 705 depends on DEBUG_KERNEL && HAVE_DEBUG_KMEMLEAK
79e0d9bd 706 select DEBUG_FS
3bba00d7
CM
707 select STACKTRACE if STACKTRACE_SUPPORT
708 select KALLSYMS
b60e26a2 709 select CRC32
3bba00d7
CM
710 help
711 Say Y here if you want to enable the memory leak
712 detector. The memory allocation/freeing is traced in a way
713 similar to the Boehm's conservative garbage collector, the
714 difference being that the orphan objects are not freed but
715 only shown in /sys/kernel/debug/kmemleak. Enabling this
716 feature will introduce an overhead to memory
700199b0 717 allocations. See Documentation/dev-tools/kmemleak.rst for more
3bba00d7
CM
718 details.
719
0610c8a8
DH
720 Enabling DEBUG_SLAB or SLUB_DEBUG may increase the chances
721 of finding leaks due to the slab objects poisoning.
722
723 In order to access the kmemleak file, debugfs needs to be
724 mounted (usually at /sys/kernel/debug).
725
c5665868
CM
726config DEBUG_KMEMLEAK_MEM_POOL_SIZE
727 int "Kmemleak memory pool size"
0610c8a8 728 depends on DEBUG_KMEMLEAK
c59180ae 729 range 200 1000000
b751c52b 730 default 16000
0610c8a8
DH
731 help
732 Kmemleak must track all the memory allocations to avoid
733 reporting false positives. Since memory may be allocated or
c5665868
CM
734 freed before kmemleak is fully initialised, use a static pool
735 of metadata objects to track such callbacks. After kmemleak is
736 fully initialised, this memory pool acts as an emergency one
737 if slab allocations fail.
0610c8a8
DH
738
739config DEBUG_KMEMLEAK_TEST
740 tristate "Simple test for the kernel memory leak detector"
741 depends on DEBUG_KMEMLEAK && m
742 help
743 This option enables a module that explicitly leaks memory.
744
745 If unsure, say N.
746
747config DEBUG_KMEMLEAK_DEFAULT_OFF
748 bool "Default kmemleak to off"
749 depends on DEBUG_KMEMLEAK
750 help
751 Say Y here to disable kmemleak by default. It can then be enabled
752 on the command line via kmemleak=on.
753
d53ce042
SK
754config DEBUG_KMEMLEAK_AUTO_SCAN
755 bool "Enable kmemleak auto scan thread on boot up"
756 default y
757 depends on DEBUG_KMEMLEAK
758 help
759 Depending on the cpu, kmemleak scan may be cpu intensive and can
760 stall user tasks at times. This option enables/disables automatic
761 kmemleak scan at boot up.
762
763 Say N here to disable kmemleak auto scan thread to stop automatic
764 scanning. Disabling this option disables automatic reporting of
765 memory leaks.
766
767 If unsure, say Y.
768
0610c8a8
DH
769config DEBUG_STACK_USAGE
770 bool "Stack utilization instrumentation"
6c31da34 771 depends on DEBUG_KERNEL && !IA64
0610c8a8
DH
772 help
773 Enables the display of the minimum amount of free stack which each
774 task has ever had available in the sysrq-T and sysrq-P debug output.
775
776 This option will slow down process creation somewhat.
777
dc9b9638
CD
778config SCHED_STACK_END_CHECK
779 bool "Detect stack corruption on calls to schedule()"
780 depends on DEBUG_KERNEL
781 default n
782 help
783 This option checks for a stack overrun on calls to schedule().
784 If the stack end location is found to be over written always panic as
785 the content of the corrupted region can no longer be trusted.
786 This is to ensure no erroneous behaviour occurs which could result in
787 data corruption or a sporadic crash at a later stage once the region
788 is examined. The runtime overhead introduced is minimal.
789
399145f9
AK
790config ARCH_HAS_DEBUG_VM_PGTABLE
791 bool
792 help
793 An architecture should select this when it can successfully
794 build and run DEBUG_VM_PGTABLE.
795
0610c8a8
DH
796config DEBUG_VM
797 bool "Debug VM"
798 depends on DEBUG_KERNEL
799 help
800 Enable this to turn on extended checks in the virtual-memory system
68d4b3df 801 that may impact performance.
0610c8a8
DH
802
803 If unsure, say N.
804
4f115147
DB
805config DEBUG_VM_VMACACHE
806 bool "Debug VMA caching"
807 depends on DEBUG_VM
808 help
809 Enable this to turn on VMA caching debug information. Doing so
810 can cause significant overhead, so only enable it in non-production
811 environments.
812
813 If unsure, say N.
814
0610c8a8
DH
815config DEBUG_VM_RB
816 bool "Debug VM red-black trees"
817 depends on DEBUG_VM
818 help
a663dad6 819 Enable VM red-black tree debugging information and extra validations.
0610c8a8
DH
820
821 If unsure, say N.
822
95ad9755
KS
823config DEBUG_VM_PGFLAGS
824 bool "Debug page-flags operations"
825 depends on DEBUG_VM
826 help
827 Enables extra validation on page flags operations.
828
829 If unsure, say N.
830
399145f9
AK
831config DEBUG_VM_PGTABLE
832 bool "Debug arch page table for semantics compliance"
833 depends on MMU
834 depends on ARCH_HAS_DEBUG_VM_PGTABLE
835 default y if DEBUG_VM
836 help
837 This option provides a debug method which can be used to test
838 architecture page table helper functions on various platforms in
839 verifying if they comply with expected generic MM semantics. This
840 will help architecture code in making sure that any changes or
841 new additions of these helpers still conform to expected
842 semantics of the generic MM. Platforms will have to opt in for
843 this through ARCH_HAS_DEBUG_VM_PGTABLE.
844
845 If unsure, say N.
846
fa5b6ec9
LA
847config ARCH_HAS_DEBUG_VIRTUAL
848 bool
849
0610c8a8
DH
850config DEBUG_VIRTUAL
851 bool "Debug VM translations"
fa5b6ec9 852 depends on DEBUG_KERNEL && ARCH_HAS_DEBUG_VIRTUAL
0610c8a8
DH
853 help
854 Enable some costly sanity checks in virtual to page code. This can
855 catch mistakes with virt_to_page() and friends.
856
857 If unsure, say N.
858
859config DEBUG_NOMMU_REGIONS
860 bool "Debug the global anon/private NOMMU mapping region tree"
861 depends on DEBUG_KERNEL && !MMU
862 help
863 This option causes the global tree of anonymous and private mapping
864 regions to be regularly checked for invalid topology.
865
866config DEBUG_MEMORY_INIT
867 bool "Debug memory initialisation" if EXPERT
868 default !EXPERT
869 help
870 Enable this for additional checks during memory initialisation.
871 The sanity checks verify aspects of the VM such as the memory model
872 and other information provided by the architecture. Verbose
873 information will be printed at KERN_DEBUG loglevel depending
874 on the mminit_loglevel= command-line option.
875
876 If unsure, say Y
877
878config MEMORY_NOTIFIER_ERROR_INJECT
879 tristate "Memory hotplug notifier error injection module"
50f9481e 880 depends on MEMORY_HOTPLUG && NOTIFIER_ERROR_INJECTION
0610c8a8
DH
881 help
882 This option provides the ability to inject artificial errors to
883 memory hotplug notifier chain callbacks. It is controlled through
884 debugfs interface under /sys/kernel/debug/notifier-error-inject/memory
885
886 If the notifier call chain should be failed with some events
887 notified, write the error code to "actions/<notifier event>/error".
888
889 Example: Inject memory hotplug offline error (-12 == -ENOMEM)
890
891 # cd /sys/kernel/debug/notifier-error-inject/memory
892 # echo -12 > actions/MEM_GOING_OFFLINE/error
893 # echo offline > /sys/devices/system/memory/memoryXXX/state
894 bash: echo: write error: Cannot allocate memory
895
896 To compile this code as a module, choose M here: the module will
897 be called memory-notifier-error-inject.
898
899 If unsure, say N.
900
901config DEBUG_PER_CPU_MAPS
902 bool "Debug access to per_cpu maps"
903 depends on DEBUG_KERNEL
904 depends on SMP
905 help
906 Say Y to verify that the per_cpu map being accessed has
907 been set up. This adds a fair amount of code to kernel memory
908 and decreases performance.
909
910 Say N if unsure.
911
6e799cb6
TG
912config DEBUG_KMAP_LOCAL
913 bool "Debug kmap_local temporary mappings"
914 depends on DEBUG_KERNEL && KMAP_LOCAL
915 help
916 This option enables additional error checking for the kmap_local
917 infrastructure. Disable for production use.
918
0e91a0c6
TG
919config ARCH_SUPPORTS_KMAP_LOCAL_FORCE_MAP
920 bool
921
922config DEBUG_KMAP_LOCAL_FORCE_MAP
923 bool "Enforce kmap_local temporary mappings"
924 depends on DEBUG_KERNEL && ARCH_SUPPORTS_KMAP_LOCAL_FORCE_MAP
925 select KMAP_LOCAL
926 select DEBUG_KMAP_LOCAL
927 help
928 This option enforces temporary mappings through the kmap_local
929 mechanism for non-highmem pages and on non-highmem systems.
930 Disable this for production systems!
931
0610c8a8
DH
932config DEBUG_HIGHMEM
933 bool "Highmem debugging"
934 depends on DEBUG_KERNEL && HIGHMEM
0e91a0c6 935 select DEBUG_KMAP_LOCAL_FORCE_MAP if ARCH_SUPPORTS_KMAP_LOCAL_FORCE_MAP
6e799cb6 936 select DEBUG_KMAP_LOCAL
0610c8a8 937 help
b1357c9f
GU
938 This option enables additional error checking for high memory
939 systems. Disable for production systems.
0610c8a8
DH
940
941config HAVE_DEBUG_STACKOVERFLOW
942 bool
943
944config DEBUG_STACKOVERFLOW
945 bool "Check for stack overflows"
946 depends on DEBUG_KERNEL && HAVE_DEBUG_STACKOVERFLOW
a7f7f624 947 help
0610c8a8 948 Say Y here if you want to check for overflows of kernel, IRQ
edb0ec07 949 and exception stacks (if your architecture uses them). This
0610c8a8
DH
950 option will show detailed messages if free stack space drops
951 below a certain limit.
952
953 These kinds of bugs usually occur when call-chains in the
954 kernel get too deep, especially when interrupts are
955 involved.
956
957 Use this in cases where you see apparently random memory
958 corruption, especially if it appears in 'struct thread_info'
959
960 If in doubt, say "N".
961
0b24becc 962source "lib/Kconfig.kasan"
0ce20dd8 963source "lib/Kconfig.kfence"
0b24becc 964
0610c8a8
DH
965endmenu # "Memory Debugging"
966
a304e1b8
DW
967config DEBUG_SHIRQ
968 bool "Debug shared IRQ handlers"
0244ad00 969 depends on DEBUG_KERNEL
a304e1b8 970 help
0a2fae2a
WS
971 Enable this to generate a spurious interrupt just before a shared
972 interrupt handler is deregistered (generating one when registering
973 is currently disabled). Drivers need to handle this correctly. Some
974 don't and need to be caught.
a304e1b8 975
f43a289d
CD
976menu "Debug Oops, Lockups and Hangs"
977
978config PANIC_ON_OOPS
979 bool "Panic on Oops"
980 help
981 Say Y here to enable the kernel to panic when it oopses. This
982 has the same effect as setting oops=panic on the kernel command
983 line.
984
985 This feature is useful to ensure that the kernel does not do
986 anything erroneous after an oops which could result in data
987 corruption or other issues.
988
989 Say N if unsure.
990
991config PANIC_ON_OOPS_VALUE
992 int
993 range 0 1
994 default 0 if !PANIC_ON_OOPS
995 default 1 if PANIC_ON_OOPS
996
997config PANIC_TIMEOUT
998 int "panic timeout"
999 default 0
1000 help
9d5b134f 1001 Set the timeout value (in seconds) until a reboot occurs when
f43a289d
CD
1002 the kernel panics. If n = 0, then we wait forever. A timeout
1003 value n > 0 will wait n seconds before rebooting, while a timeout
1004 value n < 0 will reboot immediately.
92aef8fb 1005
58687acb 1006config LOCKUP_DETECTOR
05a4a952
NP
1007 bool
1008
1009config SOFTLOCKUP_DETECTOR
1010 bool "Detect Soft Lockups"
dea20a3f 1011 depends on DEBUG_KERNEL && !S390
05a4a952 1012 select LOCKUP_DETECTOR
8446f1d3 1013 help
58687acb 1014 Say Y here to enable the kernel to act as a watchdog to detect
05a4a952 1015 soft lockups.
58687acb
DZ
1016
1017 Softlockups are bugs that cause the kernel to loop in kernel
5f329089 1018 mode for more than 20 seconds, without giving other tasks a
58687acb
DZ
1019 chance to run. The current stack trace is displayed upon
1020 detection and the system will stay locked up.
8446f1d3 1021
5f00ae0d
RD
1022config BOOTPARAM_SOFTLOCKUP_PANIC
1023 bool "Panic (Reboot) On Soft Lockups"
1024 depends on SOFTLOCKUP_DETECTOR
1025 help
1026 Say Y here to enable the kernel to panic on "soft lockups",
1027 which are bugs that cause the kernel to loop in kernel
1028 mode for more than 20 seconds (configurable using the watchdog_thresh
1029 sysctl), without giving other tasks a chance to run.
1030
1031 The panic can be used in combination with panic_timeout,
1032 to cause the system to reboot automatically after a
1033 lockup has been detected. This feature is useful for
1034 high-availability systems that have uptime guarantees and
1035 where a lockup must be resolved ASAP.
1036
1037 Say N if unsure.
1038
1039config BOOTPARAM_SOFTLOCKUP_PANIC_VALUE
1040 int
1041 depends on SOFTLOCKUP_DETECTOR
1042 range 0 1
1043 default 0 if !BOOTPARAM_SOFTLOCKUP_PANIC
1044 default 1 if BOOTPARAM_SOFTLOCKUP_PANIC
1045
05a4a952
NP
1046config HARDLOCKUP_DETECTOR_PERF
1047 bool
1048 select SOFTLOCKUP_DETECTOR
1049
7edaeb68
TG
1050#
1051# Enables a timestamp based low pass filter to compensate for perf based
1052# hard lockup detection which runs too fast due to turbo modes.
1053#
1054config HARDLOCKUP_CHECK_TIMESTAMP
1055 bool
1056
05a4a952
NP
1057#
1058# arch/ can define HAVE_HARDLOCKUP_DETECTOR_ARCH to provide their own hard
1059# lockup detector rather than the perf based detector.
1060#
1061config HARDLOCKUP_DETECTOR
1062 bool "Detect Hard Lockups"
1063 depends on DEBUG_KERNEL && !S390
1064 depends on HAVE_HARDLOCKUP_DETECTOR_PERF || HAVE_HARDLOCKUP_DETECTOR_ARCH
1065 select LOCKUP_DETECTOR
1066 select HARDLOCKUP_DETECTOR_PERF if HAVE_HARDLOCKUP_DETECTOR_PERF
05a4a952
NP
1067 help
1068 Say Y here to enable the kernel to act as a watchdog to detect
1069 hard lockups.
1070
58687acb 1071 Hardlockups are bugs that cause the CPU to loop in kernel mode
5f329089 1072 for more than 10 seconds, without letting other interrupts have a
58687acb
DZ
1073 chance to run. The current stack trace is displayed upon detection
1074 and the system will stay locked up.
8446f1d3 1075
fef2c9bc
DZ
1076config BOOTPARAM_HARDLOCKUP_PANIC
1077 bool "Panic (Reboot) On Hard Lockups"
8f1f66ed 1078 depends on HARDLOCKUP_DETECTOR
fef2c9bc
DZ
1079 help
1080 Say Y here to enable the kernel to panic on "hard lockups",
1081 which are bugs that cause the kernel to loop in kernel
5f329089
FLVC
1082 mode with interrupts disabled for more than 10 seconds (configurable
1083 using the watchdog_thresh sysctl).
fef2c9bc
DZ
1084
1085 Say N if unsure.
1086
1087config BOOTPARAM_HARDLOCKUP_PANIC_VALUE
1088 int
8f1f66ed 1089 depends on HARDLOCKUP_DETECTOR
fef2c9bc
DZ
1090 range 0 1
1091 default 0 if !BOOTPARAM_HARDLOCKUP_PANIC
1092 default 1 if BOOTPARAM_HARDLOCKUP_PANIC
1093
e162b39a
MSB
1094config DETECT_HUNG_TASK
1095 bool "Detect Hung Tasks"
1096 depends on DEBUG_KERNEL
05a4a952 1097 default SOFTLOCKUP_DETECTOR
e162b39a 1098 help
0610c8a8
DH
1099 Say Y here to enable the kernel to detect "hung tasks",
1100 which are bugs that cause the task to be stuck in
96b03ab8 1101 uninterruptible "D" state indefinitely.
1da177e4 1102
0610c8a8
DH
1103 When a hung task is detected, the kernel will print the
1104 current stack trace (which you should report), but the
1105 task will stay in uninterruptible state. If lockdep is
1106 enabled then all held locks will also be reported. This
1107 feature has negligible overhead.
871751e2 1108
0610c8a8
DH
1109config DEFAULT_HUNG_TASK_TIMEOUT
1110 int "Default timeout for hung task detection (in seconds)"
1111 depends on DETECT_HUNG_TASK
1112 default 120
f0630fff 1113 help
0610c8a8
DH
1114 This option controls the default timeout (in seconds) used
1115 to determine when a task has become non-responsive and should
1116 be considered hung.
f0630fff 1117
0610c8a8
DH
1118 It can be adjusted at runtime via the kernel.hung_task_timeout_secs
1119 sysctl or by writing a value to
1120 /proc/sys/kernel/hung_task_timeout_secs.
8ff12cfc 1121
0610c8a8
DH
1122 A timeout of 0 disables the check. The default is two minutes.
1123 Keeping the default should be fine in most cases.
b69ec42b 1124
0610c8a8
DH
1125config BOOTPARAM_HUNG_TASK_PANIC
1126 bool "Panic (Reboot) On Hung Tasks"
1127 depends on DETECT_HUNG_TASK
3bba00d7 1128 help
0610c8a8
DH
1129 Say Y here to enable the kernel to panic on "hung tasks",
1130 which are bugs that cause the kernel to leave a task stuck
1131 in uninterruptible "D" state.
3bba00d7 1132
0610c8a8
DH
1133 The panic can be used in combination with panic_timeout,
1134 to cause the system to reboot automatically after a
1135 hung task has been detected. This feature is useful for
1136 high-availability systems that have uptime guarantees and
1137 where a hung tasks must be resolved ASAP.
bf96d1e3 1138
0610c8a8 1139 Say N if unsure.
bf96d1e3 1140
0610c8a8
DH
1141config BOOTPARAM_HUNG_TASK_PANIC_VALUE
1142 int
1143 depends on DETECT_HUNG_TASK
1144 range 0 1
1145 default 0 if !BOOTPARAM_HUNG_TASK_PANIC
1146 default 1 if BOOTPARAM_HUNG_TASK_PANIC
3bba00d7 1147
82607adc
TH
1148config WQ_WATCHDOG
1149 bool "Detect Workqueue Stalls"
1150 depends on DEBUG_KERNEL
1151 help
1152 Say Y here to enable stall detection on workqueues. If a
1153 worker pool doesn't make forward progress on a pending work
1154 item for over a given amount of time, 30s by default, a
1155 warning message is printed along with dump of workqueue
1156 state. This can be configured through kernel parameter
1157 "workqueue.watchdog_thresh" and its sysfs counterpart.
1158
30428ef5
KK
1159config TEST_LOCKUP
1160 tristate "Test module to generate lockups"
63646bc9 1161 depends on m
30428ef5
KK
1162 help
1163 This builds the "test_lockup" module that helps to make sure
1164 that watchdogs and lockup detectors are working properly.
1165
1166 Depending on module parameters it could emulate soft or hard
1167 lockup, "hung task", or locking arbitrary lock for a long time.
1168 Also it could generate series of lockups with cooling-down periods.
1169
1170 If unsure, say N.
1171
92aef8fb
DH
1172endmenu # "Debug lockups and hangs"
1173
ebebdd09 1174menu "Scheduler Debugging"
5800dc3c 1175
0610c8a8
DH
1176config SCHED_DEBUG
1177 bool "Collect scheduler debugging info"
1178 depends on DEBUG_KERNEL && PROC_FS
1179 default y
0822ee4a 1180 help
0610c8a8
DH
1181 If you say Y here, the /proc/sched_debug file will be provided
1182 that can help debug the scheduler. The runtime overhead of this
1183 option is minimal.
0822ee4a 1184
f6db8347
NR
1185config SCHED_INFO
1186 bool
1187 default n
1188
0610c8a8
DH
1189config SCHEDSTATS
1190 bool "Collect scheduler statistics"
1191 depends on DEBUG_KERNEL && PROC_FS
f6db8347 1192 select SCHED_INFO
0610c8a8
DH
1193 help
1194 If you say Y here, additional code will be inserted into the
1195 scheduler and related routines to collect statistics about
1196 scheduler behavior and provide them in /proc/schedstat. These
1197 stats may be useful for both tuning and debugging the scheduler
1198 If you aren't debugging the scheduler or trying to tune a specific
1199 application, you can say N to avoid the very slight overhead
1200 this adds.
0822ee4a 1201
ebebdd09 1202endmenu
0d9e2632 1203
3c17ad19
JS
1204config DEBUG_TIMEKEEPING
1205 bool "Enable extra timekeeping sanity checking"
1206 help
1207 This option will enable additional timekeeping sanity checks
1208 which may be helpful when diagnosing issues where timekeeping
1209 problems are suspected.
1210
1211 This may include checks in the timekeeping hotpaths, so this
1212 option may have a (very small) performance impact to some
1213 workloads.
1214
1215 If unsure, say N.
1216
1da177e4
LT
1217config DEBUG_PREEMPT
1218 bool "Debug preemptible kernel"
9f472869 1219 depends on DEBUG_KERNEL && PREEMPTION && TRACE_IRQFLAGS_SUPPORT
1da177e4
LT
1220 default y
1221 help
1222 If you say Y here then the kernel will use a debug variant of the
1223 commonly used smp_processor_id() function and will print warnings
1224 if kernel code uses it in a preemption-unsafe way. Also, the kernel
1225 will detect preemption count underflows.
1226
9eade16b
DH
1227menu "Lock Debugging (spinlocks, mutexes, etc...)"
1228
f07cbebb
WL
1229config LOCK_DEBUGGING_SUPPORT
1230 bool
1231 depends on TRACE_IRQFLAGS_SUPPORT && STACKTRACE_SUPPORT && LOCKDEP_SUPPORT
1232 default y
1233
19193bca
WL
1234config PROVE_LOCKING
1235 bool "Lock debugging: prove locking correctness"
1236 depends on DEBUG_KERNEL && LOCK_DEBUGGING_SUPPORT
1237 select LOCKDEP
1238 select DEBUG_SPINLOCK
bb630f9f 1239 select DEBUG_MUTEXES if !PREEMPT_RT
19193bca 1240 select DEBUG_RT_MUTEXES if RT_MUTEXES
c71fd893 1241 select DEBUG_RWSEMS
19193bca
WL
1242 select DEBUG_WW_MUTEX_SLOWPATH
1243 select DEBUG_LOCK_ALLOC
8fd8ad5c 1244 select PREEMPT_COUNT if !ARCH_NO_PREEMPT
19193bca
WL
1245 select TRACE_IRQFLAGS
1246 default n
1247 help
1248 This feature enables the kernel to prove that all locking
1249 that occurs in the kernel runtime is mathematically
1250 correct: that under no circumstance could an arbitrary (and
1251 not yet triggered) combination of observed locking
1252 sequences (on an arbitrary number of CPUs, running an
1253 arbitrary number of tasks and interrupt contexts) cause a
1254 deadlock.
1255
1256 In short, this feature enables the kernel to report locking
1257 related deadlocks before they actually occur.
1258
1259 The proof does not depend on how hard and complex a
1260 deadlock scenario would be to trigger: how many
1261 participant CPUs, tasks and irq-contexts would be needed
1262 for it to trigger. The proof also does not depend on
1263 timing: if a race and a resulting deadlock is possible
1264 theoretically (no matter how unlikely the race scenario
1265 is), it will be proven so and will immediately be
1266 reported by the kernel (once the event is observed that
1267 makes the deadlock theoretically possible).
1268
1269 If a deadlock is impossible (i.e. the locking rules, as
1270 observed by the kernel, are mathematically correct), the
1271 kernel reports nothing.
1272
1273 NOTE: this feature can also be enabled for rwlocks, mutexes
1274 and rwsems - in which case all dependencies between these
1275 different locking variants are observed and mapped too, and
1276 the proof of observed correctness is also maintained for an
1277 arbitrary combination of these separate locking variants.
1278
387b1468 1279 For more details, see Documentation/locking/lockdep-design.rst.
19193bca 1280
de8f5e4f
PZ
1281config PROVE_RAW_LOCK_NESTING
1282 bool "Enable raw_spinlock - spinlock nesting checks"
1283 depends on PROVE_LOCKING
1284 default n
1285 help
1286 Enable the raw_spinlock vs. spinlock nesting checks which ensure
1287 that the lock nesting rules for PREEMPT_RT enabled kernels are
1288 not violated.
1289
1290 NOTE: There are known nesting problems. So if you enable this
1291 option expect lockdep splats until these problems have been fully
1292 addressed which is work in progress. This config switch allows to
1293 identify and analyze these problems. It will be removed and the
9dbbc3b9 1294 check permanently enabled once the main issues have been fixed.
de8f5e4f
PZ
1295
1296 If unsure, select N.
1297
19193bca
WL
1298config LOCK_STAT
1299 bool "Lock usage statistics"
1300 depends on DEBUG_KERNEL && LOCK_DEBUGGING_SUPPORT
1301 select LOCKDEP
1302 select DEBUG_SPINLOCK
bb630f9f 1303 select DEBUG_MUTEXES if !PREEMPT_RT
19193bca
WL
1304 select DEBUG_RT_MUTEXES if RT_MUTEXES
1305 select DEBUG_LOCK_ALLOC
1306 default n
1307 help
1308 This feature enables tracking lock contention points
1309
387b1468 1310 For more details, see Documentation/locking/lockstat.rst
19193bca
WL
1311
1312 This also enables lock events required by "perf lock",
1313 subcommand of perf.
1314 If you want to use "perf lock", you also need to turn on
1315 CONFIG_EVENT_TRACING.
1316
1317 CONFIG_LOCK_STAT defines "contended" and "acquired" lock events.
1318 (CONFIG_LOCKDEP defines "acquire" and "release" events.)
1319
e7eebaf6
IM
1320config DEBUG_RT_MUTEXES
1321 bool "RT Mutex debugging, deadlock detection"
e7eebaf6
IM
1322 depends on DEBUG_KERNEL && RT_MUTEXES
1323 help
1324 This allows rt mutex semantics violations and rt mutex related
1325 deadlocks (lockups) to be detected and reported automatically.
1326
1da177e4 1327config DEBUG_SPINLOCK
4d9f34ad 1328 bool "Spinlock and rw-lock debugging: basic checks"
1da177e4 1329 depends on DEBUG_KERNEL
e335e3eb 1330 select UNINLINE_SPIN_UNLOCK
1da177e4
LT
1331 help
1332 Say Y here and build SMP to catch missing spinlock initialization
1333 and certain other kinds of spinlock errors commonly made. This is
1334 best used in conjunction with the NMI watchdog so that spinlock
1335 deadlocks are also debuggable.
1336
4d9f34ad
IM
1337config DEBUG_MUTEXES
1338 bool "Mutex debugging: basic checks"
bb630f9f 1339 depends on DEBUG_KERNEL && !PREEMPT_RT
4d9f34ad
IM
1340 help
1341 This feature allows mutex semantics violations to be detected and
1342 reported.
1343
23010027
DV
1344config DEBUG_WW_MUTEX_SLOWPATH
1345 bool "Wait/wound mutex debugging: Slowpath testing"
f07cbebb 1346 depends on DEBUG_KERNEL && LOCK_DEBUGGING_SUPPORT
23010027
DV
1347 select DEBUG_LOCK_ALLOC
1348 select DEBUG_SPINLOCK
bb630f9f
TG
1349 select DEBUG_MUTEXES if !PREEMPT_RT
1350 select DEBUG_RT_MUTEXES if PREEMPT_RT
23010027
DV
1351 help
1352 This feature enables slowpath testing for w/w mutex users by
1353 injecting additional -EDEADLK wound/backoff cases. Together with
1354 the full mutex checks enabled with (CONFIG_PROVE_LOCKING) this
1355 will test all possible w/w mutex interface abuse with the
1356 exception of simply not acquiring all the required locks.
4d692373
RC
1357 Note that this feature can introduce significant overhead, so
1358 it really should not be enabled in a production or distro kernel,
1359 even a debug kernel. If you are a driver writer, enable it. If
1360 you are a distro, do not.
23010027 1361
5149cbac
WL
1362config DEBUG_RWSEMS
1363 bool "RW Semaphore debugging: basic checks"
c71fd893 1364 depends on DEBUG_KERNEL
5149cbac 1365 help
c71fd893
WL
1366 This debugging feature allows mismatched rw semaphore locks
1367 and unlocks to be detected and reported.
5149cbac 1368
4d9f34ad
IM
1369config DEBUG_LOCK_ALLOC
1370 bool "Lock debugging: detect incorrect freeing of live locks"
f07cbebb 1371 depends on DEBUG_KERNEL && LOCK_DEBUGGING_SUPPORT
4d9f34ad 1372 select DEBUG_SPINLOCK
bb630f9f 1373 select DEBUG_MUTEXES if !PREEMPT_RT
f5694788 1374 select DEBUG_RT_MUTEXES if RT_MUTEXES
4d9f34ad
IM
1375 select LOCKDEP
1376 help
1377 This feature will check whether any held lock (spinlock, rwlock,
1378 mutex or rwsem) is incorrectly freed by the kernel, via any of the
1379 memory-freeing routines (kfree(), kmem_cache_free(), free_pages(),
1380 vfree(), etc.), whether a live lock is incorrectly reinitialized via
1381 spin_lock_init()/mutex_init()/etc., or whether there is any lock
1382 held during task exit.
1383
4d9f34ad
IM
1384config LOCKDEP
1385 bool
f07cbebb 1386 depends on DEBUG_KERNEL && LOCK_DEBUGGING_SUPPORT
4d9f34ad 1387 select STACKTRACE
4d9f34ad
IM
1388 select KALLSYMS
1389 select KALLSYMS_ALL
1390
395102db
DJ
1391config LOCKDEP_SMALL
1392 bool
1393
5dc33592
TH
1394config LOCKDEP_BITS
1395 int "Bitsize for MAX_LOCKDEP_ENTRIES"
1396 depends on LOCKDEP && !LOCKDEP_SMALL
1397 range 10 30
1398 default 15
1399 help
1400 Try increasing this value if you hit "BUG: MAX_LOCKDEP_ENTRIES too low!" message.
1401
1402config LOCKDEP_CHAINS_BITS
1403 int "Bitsize for MAX_LOCKDEP_CHAINS"
1404 depends on LOCKDEP && !LOCKDEP_SMALL
1405 range 10 30
1406 default 16
1407 help
1408 Try increasing this value if you hit "BUG: MAX_LOCKDEP_CHAINS too low!" message.
1409
1410config LOCKDEP_STACK_TRACE_BITS
1411 int "Bitsize for MAX_STACK_TRACE_ENTRIES"
1412 depends on LOCKDEP && !LOCKDEP_SMALL
1413 range 10 30
1414 default 19
1415 help
1416 Try increasing this value if you hit "BUG: MAX_STACK_TRACE_ENTRIES too low!" message.
1417
1418config LOCKDEP_STACK_TRACE_HASH_BITS
1419 int "Bitsize for STACK_TRACE_HASH_SIZE"
1420 depends on LOCKDEP && !LOCKDEP_SMALL
1421 range 10 30
1422 default 14
1423 help
1424 Try increasing this value if you need large MAX_STACK_TRACE_ENTRIES.
1425
1426config LOCKDEP_CIRCULAR_QUEUE_BITS
1427 int "Bitsize for elements in circular_queue struct"
1428 depends on LOCKDEP
1429 range 10 30
1430 default 12
1431 help
1432 Try increasing this value if you hit "lockdep bfs error:-1" warning due to __cq_enqueue() failure.
1433
4d9f34ad
IM
1434config DEBUG_LOCKDEP
1435 bool "Lock dependency engine debugging"
517e7aa5 1436 depends on DEBUG_KERNEL && LOCKDEP
997acaf6 1437 select DEBUG_IRQFLAGS
4d9f34ad
IM
1438 help
1439 If you say Y here, the lock dependency engine will do
1440 additional runtime checks to debug itself, at the price
1441 of more runtime overhead.
1442
d902db1e
FW
1443config DEBUG_ATOMIC_SLEEP
1444 bool "Sleep inside atomic section checking"
e8f7c70f 1445 select PREEMPT_COUNT
1da177e4 1446 depends on DEBUG_KERNEL
87a4c375 1447 depends on !ARCH_NO_PREEMPT
1da177e4
LT
1448 help
1449 If you say Y here, various routines which may sleep will become very
d902db1e
FW
1450 noisy if they are called inside atomic sections: when a spinlock is
1451 held, inside an rcu read side critical section, inside preempt disabled
1452 sections, inside an interrupt, etc...
1da177e4 1453
cae2ed9a
IM
1454config DEBUG_LOCKING_API_SELFTESTS
1455 bool "Locking API boot-time self-tests"
1456 depends on DEBUG_KERNEL
1457 help
1458 Say Y here if you want the kernel to run a short self-test during
1459 bootup. The self-test checks whether common types of locking bugs
1460 are detected by debugging mechanisms or not. (if you disable
9dbbc3b9 1461 lock debugging then those bugs won't be detected of course.)
cae2ed9a
IM
1462 The following locking APIs are covered: spinlocks, rwlocks,
1463 mutexes and rwsems.
1464
0af3fe1e
PM
1465config LOCK_TORTURE_TEST
1466 tristate "torture tests for locking"
1467 depends on DEBUG_KERNEL
1468 select TORTURE_TEST
0af3fe1e
PM
1469 help
1470 This option provides a kernel module that runs torture tests
1471 on kernel locking primitives. The kernel module may be built
1472 after the fact on the running kernel to be tested, if desired.
1473
1474 Say Y here if you want kernel locking-primitive torture tests
1475 to be built into the kernel.
1476 Say M if you want these torture tests to build as a module.
1477 Say N if you are unsure.
1478
f2a5fec1
CW
1479config WW_MUTEX_SELFTEST
1480 tristate "Wait/wound mutex selftests"
1481 help
1482 This option provides a kernel module that runs tests on the
1483 on the struct ww_mutex locking API.
1484
1485 It is recommended to enable DEBUG_WW_MUTEX_SLOWPATH in conjunction
1486 with this test harness.
1487
1488 Say M if you want these self tests to build as a module.
1489 Say N if you are unsure.
1490
e9d338a0
PM
1491config SCF_TORTURE_TEST
1492 tristate "torture tests for smp_call_function*()"
1493 depends on DEBUG_KERNEL
1494 select TORTURE_TEST
1495 help
1496 This option provides a kernel module that runs torture tests
1497 on the smp_call_function() family of primitives. The kernel
1498 module may be built after the fact on the running kernel to
1499 be tested, if desired.
1500
35feb604
PM
1501config CSD_LOCK_WAIT_DEBUG
1502 bool "Debugging for csd_lock_wait(), called from smp_call_function*()"
1503 depends on DEBUG_KERNEL
1504 depends on 64BIT
1505 default n
1506 help
1507 This option enables debug prints when CPUs are slow to respond
1508 to the smp_call_function*() IPI wrappers. These debug prints
1509 include the IPI handler function currently executing (if any)
1510 and relevant stack traces.
1511
9eade16b 1512endmenu # lock debugging
8637c099 1513
9eade16b 1514config TRACE_IRQFLAGS
ed004953 1515 depends on TRACE_IRQFLAGS_SUPPORT
9eade16b 1516 bool
5ca43f6c 1517 help
9eade16b
DH
1518 Enables hooks to interrupt enabling and disabling for
1519 either tracing or lock debugging.
5ca43f6c 1520
ed004953 1521config TRACE_IRQFLAGS_NMI
1522 def_bool y
1523 depends on TRACE_IRQFLAGS
1524 depends on TRACE_IRQFLAGS_NMI_SUPPORT
1525
997acaf6
MR
1526config DEBUG_IRQFLAGS
1527 bool "Debug IRQ flag manipulation"
1528 help
1529 Enables checks for potentially unsafe enabling or disabling of
1530 interrupts, such as calling raw_local_irq_restore() when interrupts
1531 are enabled.
1532
8637c099 1533config STACKTRACE
0c38e1fe 1534 bool "Stack backtrace support"
8637c099 1535 depends on STACKTRACE_SUPPORT
0c38e1fe
DJ
1536 help
1537 This option causes the kernel to create a /proc/pid/stack for
1538 every process, showing its current stack trace.
1539 It is also used by various kernel debugging features that require
1540 stack trace generation.
5ca43f6c 1541
eecabf56
TT
1542config WARN_ALL_UNSEEDED_RANDOM
1543 bool "Warn for all uses of unseeded randomness"
1544 default n
d06bfd19
JD
1545 help
1546 Some parts of the kernel contain bugs relating to their use of
1547 cryptographically secure random numbers before it's actually possible
1548 to generate those numbers securely. This setting ensures that these
1549 flaws don't go unnoticed, by enabling a message, should this ever
1550 occur. This will allow people with obscure setups to know when things
1551 are going wrong, so that they might contact developers about fixing
1552 it.
1553
eecabf56
TT
1554 Unfortunately, on some models of some architectures getting
1555 a fully seeded CRNG is extremely difficult, and so this can
1556 result in dmesg getting spammed for a surprisingly long
1557 time. This is really bad from a security perspective, and
1558 so architecture maintainers really need to do what they can
1559 to get the CRNG seeded sooner after the system is booted.
4c5d114e 1560 However, since users cannot do anything actionable to
eecabf56
TT
1561 address this, by default the kernel will issue only a single
1562 warning for the first use of unseeded randomness.
1563
1564 Say Y here if you want to receive warnings for all uses of
1565 unseeded randomness. This will be of use primarily for
4c5d114e 1566 those developers interested in improving the security of
eecabf56
TT
1567 Linux kernels running on their architecture (or
1568 subarchitecture).
d06bfd19 1569
1da177e4
LT
1570config DEBUG_KOBJECT
1571 bool "kobject debugging"
1572 depends on DEBUG_KERNEL
1573 help
1574 If you say Y here, some extra kobject debugging messages will be sent
aca52c39 1575 to the syslog.
1da177e4 1576
c817a67e
RK
1577config DEBUG_KOBJECT_RELEASE
1578 bool "kobject release debugging"
2a999aa0 1579 depends on DEBUG_OBJECTS_TIMERS
c817a67e
RK
1580 help
1581 kobjects are reference counted objects. This means that their
1582 last reference count put is not predictable, and the kobject can
1583 live on past the point at which a driver decides to drop it's
1584 initial reference to the kobject gained on allocation. An
1585 example of this would be a struct device which has just been
1586 unregistered.
1587
1588 However, some buggy drivers assume that after such an operation,
1589 the memory backing the kobject can be immediately freed. This
1590 goes completely against the principles of a refcounted object.
1591
1592 If you say Y here, the kernel will delay the release of kobjects
1593 on the last reference count to improve the visibility of this
1594 kind of kobject release bug.
1595
9b2a60c4
CM
1596config HAVE_DEBUG_BUGVERBOSE
1597 bool
1598
3be5cbcd 1599menu "Debug kernel data structures"
1da177e4 1600
199a9afc
DJ
1601config DEBUG_LIST
1602 bool "Debug linked list manipulation"
4520bcb2 1603 depends on DEBUG_KERNEL || BUG_ON_DATA_CORRUPTION
199a9afc
DJ
1604 help
1605 Enable this to turn on extended checks in the linked-list
1606 walking routines.
1607
1608 If unsure, say N.
1609
8e18faea 1610config DEBUG_PLIST
b8cfff68
DS
1611 bool "Debug priority linked list manipulation"
1612 depends on DEBUG_KERNEL
1613 help
1614 Enable this to turn on extended checks in the priority-ordered
1615 linked-list (plist) walking routines. This checks the entire
1616 list multiple times during each manipulation.
1617
1618 If unsure, say N.
1619
d6ec0842
JA
1620config DEBUG_SG
1621 bool "Debug SG table operations"
1622 depends on DEBUG_KERNEL
1623 help
1624 Enable this to turn on checks on scatter-gather tables. This can
1625 help find problems with drivers that do not properly initialize
1626 their sg tables.
1627
1628 If unsure, say N.
1629
1b2439db
AV
1630config DEBUG_NOTIFIERS
1631 bool "Debug notifier call chains"
1632 depends on DEBUG_KERNEL
1633 help
1634 Enable this to turn on sanity checking for notifier call chains.
1635 This is most useful for kernel developers to make sure that
1636 modules properly unregister themselves from notifier chains.
1637 This is a relatively cheap check but if you care about maximum
1638 performance, say N.
1639
3be5cbcd
CD
1640config BUG_ON_DATA_CORRUPTION
1641 bool "Trigger a BUG when data corruption is detected"
1642 select DEBUG_LIST
1643 help
1644 Select this option if the kernel should BUG when it encounters
1645 data corruption in kernel memory structures when they get checked
1646 for validity.
1647
1648 If unsure, say N.
1649
1650endmenu
1651
e0e81739
DH
1652config DEBUG_CREDENTIALS
1653 bool "Debug credential management"
1654 depends on DEBUG_KERNEL
1655 help
1656 Enable this to turn on some debug checking for credential
1657 management. The additional code keeps track of the number of
1658 pointers from task_structs to any given cred struct, and checks to
1659 see that this number never exceeds the usage count of the cred
1660 struct.
1661
1662 Furthermore, if SELinux is enabled, this also checks that the
1663 security pointer in the cred struct is never seen to be invalid.
1664
1665 If unsure, say N.
1666
43a0a2a7 1667source "kernel/rcu/Kconfig.debug"
2f03e3ca 1668
f303fccb
TH
1669config DEBUG_WQ_FORCE_RR_CPU
1670 bool "Force round-robin CPU selection for unbound work items"
1671 depends on DEBUG_KERNEL
1672 default n
1673 help
1674 Workqueue used to implicitly guarantee that work items queued
1675 without explicit CPU specified are put on the local CPU. This
1676 guarantee is no longer true and while local CPU is still
1677 preferred work items may be put on foreign CPUs. Kernel
1678 parameter "workqueue.debug_force_rr_cpu" is added to force
1679 round-robin CPU selection to flush out usages which depend on the
1680 now broken guarantee. This config option enables the debug
1681 feature by default. When enabled, memory and cache locality will
1682 be impacted.
1683
757c989b
TG
1684config CPU_HOTPLUG_STATE_CONTROL
1685 bool "Enable CPU hotplug state control"
1686 depends on DEBUG_KERNEL
1687 depends on HOTPLUG_CPU
1688 default n
1689 help
1690 Allows to write steps between "offline" and "online" to the CPUs
1691 sysfs target file so states can be stepped granular. This is a debug
1692 option for now as the hotplug machinery cannot be stopped and
1693 restarted at arbitrary points yet.
1694
1695 Say N if your are unsure.
1696
09a74952
CD
1697config LATENCYTOP
1698 bool "Latency measuring infrastructure"
1699 depends on DEBUG_KERNEL
1700 depends on STACKTRACE_SUPPORT
1701 depends on PROC_FS
7d37cb2c 1702 depends on FRAME_POINTER || MIPS || PPC || S390 || MICROBLAZE || ARM || ARC || X86
09a74952
CD
1703 select KALLSYMS
1704 select KALLSYMS_ALL
1705 select STACKTRACE
1706 select SCHEDSTATS
09a74952
CD
1707 help
1708 Enable this option if you want to use the LatencyTOP tool
1709 to find out which userspace is blocking on what kernel operations.
1710
1711source "kernel/trace/Kconfig"
1712
1713config PROVIDE_OHCI1394_DMA_INIT
1714 bool "Remote debugging over FireWire early on boot"
1715 depends on PCI && X86
1716 help
1717 If you want to debug problems which hang or crash the kernel early
1718 on boot and the crashing machine has a FireWire port, you can use
1719 this feature to remotely access the memory of the crashed machine
1720 over FireWire. This employs remote DMA as part of the OHCI1394
1721 specification which is now the standard for FireWire controllers.
1722
1723 With remote DMA, you can monitor the printk buffer remotely using
1724 firescope and access all memory below 4GB using fireproxy from gdb.
1725 Even controlling a kernel debugger is possible using remote DMA.
1726
1727 Usage:
1728
1729 If ohci1394_dma=early is used as boot parameter, it will initialize
1730 all OHCI1394 controllers which are found in the PCI config space.
1731
1732 As all changes to the FireWire bus such as enabling and disabling
1733 devices cause a bus reset and thereby disable remote DMA for all
1734 devices, be sure to have the cable plugged and FireWire enabled on
1735 the debugging host before booting the debug target for debugging.
1736
1737 This code (~1k) is freed after boot. By then, the firewire stack
1738 in charge of the OHCI-1394 controllers should be used instead.
1739
a74e2a22 1740 See Documentation/core-api/debugging-via-ohci1394.rst for more information.
09a74952 1741
045f6d79
CD
1742source "samples/Kconfig"
1743
1744config ARCH_HAS_DEVMEM_IS_ALLOWED
1745 bool
1746
1747config STRICT_DEVMEM
1748 bool "Filter access to /dev/mem"
1749 depends on MMU && DEVMEM
527701ed 1750 depends on ARCH_HAS_DEVMEM_IS_ALLOWED || GENERIC_LIB_DEVMEM_IS_ALLOWED
045f6d79
CD
1751 default y if PPC || X86 || ARM64
1752 help
1753 If this option is disabled, you allow userspace (root) access to all
1754 of memory, including kernel and userspace memory. Accidental
1755 access to this is obviously disastrous, but specific access can
1756 be used by people debugging the kernel. Note that with PAT support
1757 enabled, even in this case there are restrictions on /dev/mem
1758 use due to the cache aliasing requirements.
1759
1760 If this option is switched on, and IO_STRICT_DEVMEM=n, the /dev/mem
1761 file only allows userspace access to PCI space and the BIOS code and
1762 data regions. This is sufficient for dosemu and X and all common
1763 users of /dev/mem.
1764
1765 If in doubt, say Y.
1766
1767config IO_STRICT_DEVMEM
1768 bool "Filter I/O access to /dev/mem"
1769 depends on STRICT_DEVMEM
1770 help
1771 If this option is disabled, you allow userspace (root) access to all
1772 io-memory regardless of whether a driver is actively using that
1773 range. Accidental access to this is obviously disastrous, but
1774 specific access can be used by people debugging kernel drivers.
1775
1776 If this option is switched on, the /dev/mem file only allows
1777 userspace access to *idle* io-memory ranges (see /proc/iomem) This
1778 may break traditional users of /dev/mem (dosemu, legacy X, etc...)
1779 if the driver using a given range cannot be disabled.
1780
1781 If in doubt, say Y.
1782
1783menu "$(SRCARCH) Debugging"
1784
1785source "arch/$(SRCARCH)/Kconfig.debug"
1786
1787endmenu
1788
1789menu "Kernel Testing and Coverage"
1790
09a74952
CD
1791source "lib/kunit/Kconfig"
1792
8d438288
AM
1793config NOTIFIER_ERROR_INJECTION
1794 tristate "Notifier error injection"
1795 depends on DEBUG_KERNEL
1796 select DEBUG_FS
1797 help
e41e85cc 1798 This option provides the ability to inject artificial errors to
8d438288
AM
1799 specified notifier chain callbacks. It is useful to test the error
1800 handling of notifier call chain failures.
1801
1802 Say N if unsure.
1803
048b9c35
AM
1804config PM_NOTIFIER_ERROR_INJECT
1805 tristate "PM notifier error injection module"
1806 depends on PM && NOTIFIER_ERROR_INJECTION
1807 default m if PM_DEBUG
1808 help
e41e85cc 1809 This option provides the ability to inject artificial errors to
048b9c35
AM
1810 PM notifier chain callbacks. It is controlled through debugfs
1811 interface /sys/kernel/debug/notifier-error-inject/pm
1812
1813 If the notifier call chain should be failed with some events
1814 notified, write the error code to "actions/<notifier event>/error".
1815
1816 Example: Inject PM suspend error (-12 = -ENOMEM)
1817
1818 # cd /sys/kernel/debug/notifier-error-inject/pm/
1819 # echo -12 > actions/PM_SUSPEND_PREPARE/error
1820 # echo mem > /sys/power/state
1821 bash: echo: write error: Cannot allocate memory
1822
1823 To compile this code as a module, choose M here: the module will
1824 be called pm-notifier-error-inject.
1825
1826 If unsure, say N.
1827
d526e85f
BH
1828config OF_RECONFIG_NOTIFIER_ERROR_INJECT
1829 tristate "OF reconfig notifier error injection module"
1830 depends on OF_DYNAMIC && NOTIFIER_ERROR_INJECTION
08dfb4dd 1831 help
e41e85cc 1832 This option provides the ability to inject artificial errors to
d526e85f 1833 OF reconfig notifier chain callbacks. It is controlled
08dfb4dd 1834 through debugfs interface under
d526e85f 1835 /sys/kernel/debug/notifier-error-inject/OF-reconfig/
08dfb4dd
AM
1836
1837 If the notifier call chain should be failed with some events
1838 notified, write the error code to "actions/<notifier event>/error".
1839
1840 To compile this code as a module, choose M here: the module will
e12a95f4 1841 be called of-reconfig-notifier-error-inject.
08dfb4dd
AM
1842
1843 If unsure, say N.
1844
02fff96a
NA
1845config NETDEV_NOTIFIER_ERROR_INJECT
1846 tristate "Netdev notifier error injection module"
1847 depends on NET && NOTIFIER_ERROR_INJECTION
1848 help
1849 This option provides the ability to inject artificial errors to
1850 netdevice notifier chain callbacks. It is controlled through debugfs
1851 interface /sys/kernel/debug/notifier-error-inject/netdev
1852
1853 If the notifier call chain should be failed with some events
1854 notified, write the error code to "actions/<notifier event>/error".
1855
1856 Example: Inject netdevice mtu change error (-22 = -EINVAL)
1857
1858 # cd /sys/kernel/debug/notifier-error-inject/netdev
1859 # echo -22 > actions/NETDEV_CHANGEMTU/error
1860 # ip link set eth0 mtu 1024
1861 RTNETLINK answers: Invalid argument
1862
1863 To compile this code as a module, choose M here: the module will
1864 be called netdev-notifier-error-inject.
1865
1866 If unsure, say N.
1867
f1b4bd06
MP
1868config FUNCTION_ERROR_INJECTION
1869 def_bool y
1870 depends on HAVE_FUNCTION_ERROR_INJECTION && KPROBES
1871
6ff1cb35 1872config FAULT_INJECTION
1ab8509a
AM
1873 bool "Fault-injection framework"
1874 depends on DEBUG_KERNEL
329409ae
AM
1875 help
1876 Provide fault-injection framework.
1877 For more details, see Documentation/fault-injection/.
6ff1cb35 1878
8a8b6502 1879config FAILSLAB
1ab8509a
AM
1880 bool "Fault-injection capability for kmalloc"
1881 depends on FAULT_INJECTION
773ff60e 1882 depends on SLAB || SLUB
8a8b6502 1883 help
1ab8509a 1884 Provide fault-injection capability for kmalloc.
8a8b6502 1885
933e312e 1886config FAIL_PAGE_ALLOC
29b46fa3 1887 bool "Fault-injection capability for alloc_pages()"
1ab8509a 1888 depends on FAULT_INJECTION
933e312e 1889 help
1ab8509a 1890 Provide fault-injection capability for alloc_pages().
933e312e 1891
2c739ced
AL
1892config FAULT_INJECTION_USERCOPY
1893 bool "Fault injection capability for usercopy functions"
1894 depends on FAULT_INJECTION
1895 help
1896 Provides fault-injection capability to inject failures
1897 in usercopy functions (copy_from_user(), get_user(), ...).
1898
c17bb495 1899config FAIL_MAKE_REQUEST
86327d19 1900 bool "Fault-injection capability for disk IO"
581d4e28 1901 depends on FAULT_INJECTION && BLOCK
c17bb495 1902 help
1ab8509a 1903 Provide fault-injection capability for disk IO.
c17bb495 1904
581d4e28 1905config FAIL_IO_TIMEOUT
f4d01439 1906 bool "Fault-injection capability for faking disk interrupts"
581d4e28
JA
1907 depends on FAULT_INJECTION && BLOCK
1908 help
1909 Provide fault-injection capability on end IO handling. This
1910 will make the block layer "forget" an interrupt as configured,
1911 thus exercising the error handling.
1912
1913 Only works with drivers that use the generic timeout handling,
9dbbc3b9 1914 for others it won't do anything.
581d4e28 1915
ab51fbab
DB
1916config FAIL_FUTEX
1917 bool "Fault-injection capability for futexes"
1918 select DEBUG_FS
1919 depends on FAULT_INJECTION && FUTEX
1920 help
1921 Provide fault-injection capability for futexes.
1922
f1b4bd06
MP
1923config FAULT_INJECTION_DEBUG_FS
1924 bool "Debugfs entries for fault-injection capabilities"
1925 depends on FAULT_INJECTION && SYSFS && DEBUG_FS
1926 help
1927 Enable configuration of fault-injection capabilities via debugfs.
1928
4b1a29a7
MH
1929config FAIL_FUNCTION
1930 bool "Fault-injection capability for functions"
1931 depends on FAULT_INJECTION_DEBUG_FS && FUNCTION_ERROR_INJECTION
1932 help
1933 Provide function-based fault-injection capability.
1934 This will allow you to override a specific function with a return
1935 with given return value. As a result, function caller will see
1936 an error value and have to handle it. This is useful to test the
1937 error handling in various subsystems.
1938
f1b4bd06
MP
1939config FAIL_MMC_REQUEST
1940 bool "Fault-injection capability for MMC IO"
1941 depends on FAULT_INJECTION_DEBUG_FS && MMC
6ff1cb35 1942 help
f1b4bd06
MP
1943 Provide fault-injection capability for MMC IO.
1944 This will make the mmc core return data errors. This is
1945 useful to test the error handling in the mmc block device
1946 and to test how the mmc host driver handles retries from
1947 the block device.
1df49008 1948
c782af25
CL
1949config FAIL_SUNRPC
1950 bool "Fault-injection capability for SunRPC"
1951 depends on FAULT_INJECTION_DEBUG_FS && SUNRPC_DEBUG
1952 help
1953 Provide fault-injection capability for SunRPC and
1954 its consumers.
1955
1df49008
AM
1956config FAULT_INJECTION_STACKTRACE_FILTER
1957 bool "stacktrace filter for fault-injection capabilities"
1958 depends on FAULT_INJECTION_DEBUG_FS && STACKTRACE_SUPPORT
6d690dca 1959 depends on !X86_64
1df49008 1960 select STACKTRACE
7d37cb2c 1961 depends on FRAME_POINTER || MIPS || PPC || S390 || MICROBLAZE || ARM || ARC || X86
1df49008
AM
1962 help
1963 Provide stacktrace filter for fault-injection capabilities
267c4025 1964
09a74952
CD
1965config ARCH_HAS_KCOV
1966 bool
cc3fa840 1967 help
09a74952
CD
1968 An architecture should select this when it can successfully
1969 build and run with CONFIG_KCOV. This typically requires
1970 disabling instrumentation for some early boot code.
cc3fa840 1971
09a74952
CD
1972config CC_HAS_SANCOV_TRACE_PC
1973 def_bool $(cc-option,-fsanitize-coverage=trace-pc)
cc3fa840 1974
cc3fa840 1975
09a74952
CD
1976config KCOV
1977 bool "Code coverage for fuzzing"
1978 depends on ARCH_HAS_KCOV
1979 depends on CC_HAS_SANCOV_TRACE_PC || GCC_PLUGINS
1980 select DEBUG_FS
1981 select GCC_PLUGIN_SANCOV if !CC_HAS_SANCOV_TRACE_PC
1982 help
1983 KCOV exposes kernel code coverage information in a form suitable
1984 for coverage-guided fuzzing (randomized testing).
cc3fa840 1985
09a74952
CD
1986 If RANDOMIZE_BASE is enabled, PC values will not be stable across
1987 different machines and across reboots. If you need stable PC values,
1988 disable RANDOMIZE_BASE.
cc3fa840 1989
09a74952 1990 For more details, see Documentation/dev-tools/kcov.rst.
cc3fa840 1991
09a74952
CD
1992config KCOV_ENABLE_COMPARISONS
1993 bool "Enable comparison operands collection by KCOV"
1994 depends on KCOV
1995 depends on $(cc-option,-fsanitize-coverage=trace-cmp)
1996 help
1997 KCOV also exposes operands of every comparison in the instrumented
1998 code along with operand sizes and PCs of the comparison instructions.
1999 These operands can be used by fuzzing engines to improve the quality
2000 of fuzzing coverage.
cc3fa840 2001
09a74952
CD
2002config KCOV_INSTRUMENT_ALL
2003 bool "Instrument all code by default"
2004 depends on KCOV
2005 default y
2006 help
2007 If you are doing generic system call fuzzing (like e.g. syzkaller),
2008 then you will want to instrument the whole kernel and you should
2009 say y here. If you are doing more targeted fuzzing (like e.g.
2010 filesystem fuzzing with AFL) then you will want to enable coverage
2011 for more specific subsets of files, and should say n here.
84bc809e 2012
5ff3b30a
AK
2013config KCOV_IRQ_AREA_SIZE
2014 hex "Size of interrupt coverage collection area in words"
2015 depends on KCOV
2016 default 0x40000
2017 help
2018 KCOV uses preallocated per-cpu areas to collect coverage from
2019 soft interrupts. This specifies the size of those areas in the
2020 number of unsigned long words.
2021
d3deafaa
VL
2022menuconfig RUNTIME_TESTING_MENU
2023 bool "Runtime Testing"
908009e8 2024 def_bool y
d3deafaa
VL
2025
2026if RUNTIME_TESTING_MENU
881c5149
DH
2027
2028config LKDTM
2029 tristate "Linux Kernel Dump Test Tool Module"
2030 depends on DEBUG_FS
881c5149
DH
2031 help
2032 This module enables testing of the different dumping mechanisms by
2033 inducing system failures at predefined crash points.
2034 If you don't need it: say N
2035 Choose M here to compile this code as a module. The module will be
2036 called lkdtm.
2037
2038 Documentation on how to use the module can be found in
10ffebbe 2039 Documentation/fault-injection/provoke-crashes.rst
881c5149
DH
2040
2041config TEST_LIST_SORT
ebd09577
DL
2042 tristate "Linked list sorting test" if !KUNIT_ALL_TESTS
2043 depends on KUNIT
2044 default KUNIT_ALL_TESTS
881c5149
DH
2045 help
2046 Enable this to turn on 'list_sort()' function test. This test is
e327fd7c
GU
2047 executed only once during system boot (so affects only boot time),
2048 or at module load time.
881c5149
DH
2049
2050 If unsure, say N.
2051
6e24628d
IR
2052config TEST_MIN_HEAP
2053 tristate "Min heap test"
2054 depends on DEBUG_KERNEL || m
2055 help
2056 Enable this to turn on min heap function tests. This test is
2057 executed only once during system boot (so affects only boot time),
2058 or at module load time.
2059
2060 If unsure, say N.
2061
c5adae95 2062config TEST_SORT
36f33b56
DL
2063 tristate "Array-based sort test" if !KUNIT_ALL_TESTS
2064 depends on KUNIT
2065 default KUNIT_ALL_TESTS
c5adae95 2066 help
5c4e6798
GU
2067 This option enables the self-test function of 'sort()' at boot,
2068 or at module load time.
c5adae95
KF
2069
2070 If unsure, say N.
2071
5086ea4b
MR
2072config TEST_DIV64
2073 tristate "64bit/32bit division and modulo test"
2074 depends on DEBUG_KERNEL || m
2075 help
2076 Enable this to turn on 'do_div()' function test. This test is
2077 executed only once during system boot (so affects only boot time),
2078 or at module load time.
2079
2080 If unsure, say N.
2081
881c5149 2082config KPROBES_SANITY_TEST
e44e81c5 2083 tristate "Kprobes sanity tests"
881c5149
DH
2084 depends on DEBUG_KERNEL
2085 depends on KPROBES
e44e81c5 2086 depends on KUNIT
881c5149
DH
2087 help
2088 This option provides for testing basic kprobes functionality on
5a6cf77f 2089 boot. Samples of kprobe and kretprobe are inserted and
881c5149
DH
2090 verified for functionality.
2091
2092 Say N if you are unsure.
2093
2094config BACKTRACE_SELF_TEST
2095 tristate "Self test for the backtrace code"
2096 depends on DEBUG_KERNEL
881c5149
DH
2097 help
2098 This option provides a kernel module that can be used to test
2099 the kernel stack backtrace code. This option is not useful
2100 for distributions or general kernels, but only for kernel
2101 developers working on architecture code.
2102
2103 Note that if you want to also test saved backtraces, you will
2104 have to enable STACKTRACE as well.
2105
2106 Say N if you are unsure.
2107
910a742d
ML
2108config RBTREE_TEST
2109 tristate "Red-Black tree test"
7c993e11 2110 depends on DEBUG_KERNEL
910a742d
ML
2111 help
2112 A benchmark measuring the performance of the rbtree library.
2113 Also includes rbtree invariant checks.
2114
4b4f3acc
FB
2115config REED_SOLOMON_TEST
2116 tristate "Reed-Solomon library test"
2117 depends on DEBUG_KERNEL || m
2118 select REED_SOLOMON
2119 select REED_SOLOMON_ENC16
2120 select REED_SOLOMON_DEC16
2121 help
2122 This option enables the self-test function of rslib at boot,
2123 or at module load time.
2124
2125 If unsure, say N.
2126
fff3fd8a
ML
2127config INTERVAL_TREE_TEST
2128 tristate "Interval tree test"
0f789b67 2129 depends on DEBUG_KERNEL
a88cc108 2130 select INTERVAL_TREE
fff3fd8a
ML
2131 help
2132 A benchmark measuring the performance of the interval tree library
2133
623fd807
GT
2134config PERCPU_TEST
2135 tristate "Per cpu operations test"
2136 depends on m && DEBUG_KERNEL
2137 help
2138 Enable this option to build test module which validates per-cpu
2139 operations.
2140
2141 If unsure, say N.
2142
881c5149 2143config ATOMIC64_SELFTEST
55ded955 2144 tristate "Perform an atomic64_t self-test"
881c5149 2145 help
55ded955
GU
2146 Enable this option to test the atomic64_t functions at boot or
2147 at module load time.
881c5149
DH
2148
2149 If unsure, say N.
2150
2151config ASYNC_RAID6_TEST
2152 tristate "Self test for hardware accelerated raid6 recovery"
2153 depends on ASYNC_RAID6_RECOV
2154 select ASYNC_MEMCPY
a7f7f624 2155 help
881c5149
DH
2156 This is a one-shot self test that permutes through the
2157 recovery of all the possible two disk failure scenarios for a
2158 N-disk array. Recovery is performed with the asynchronous
2159 raid6 recovery routines, and will optionally use an offload
2160 engine if one is available.
2161
2162 If unsure, say N.
2163
64d1d77a
AS
2164config TEST_HEXDUMP
2165 tristate "Test functions located in the hexdump module at runtime"
2166
b2ff70a0
MC
2167config STRING_SELFTEST
2168 tristate "Test string functions at runtime"
2169
881c5149
DH
2170config TEST_STRING_HELPERS
2171 tristate "Test functions located in the string_helpers module at runtime"
2172
0b0600c8
TH
2173config TEST_STRSCPY
2174 tristate "Test strscpy*() family of functions at runtime"
2175
881c5149
DH
2176config TEST_KSTRTOX
2177 tristate "Test kstrto*() family of functions at runtime"
2178
707cc728
RV
2179config TEST_PRINTF
2180 tristate "Test printf() family of functions at runtime"
2181
50f530e1
RF
2182config TEST_SCANF
2183 tristate "Test scanf() family of functions at runtime"
2184
5fd003f5
DD
2185config TEST_BITMAP
2186 tristate "Test bitmap_*() family of functions at runtime"
5fd003f5
DD
2187 help
2188 Enable this option to test the bitmap functions at boot.
2189
2190 If unsure, say N.
2191
cfaff0e5
AS
2192config TEST_UUID
2193 tristate "Test functions located in the uuid module at runtime"
2194
ad3d6c72
MW
2195config TEST_XARRAY
2196 tristate "Test the XArray code at runtime"
2197
455a35a6
RV
2198config TEST_OVERFLOW
2199 tristate "Test check_*_overflow() functions at runtime"
2200
7e1e7763 2201config TEST_RHASHTABLE
9d6dbe1b 2202 tristate "Perform selftest on resizable hash table"
7e1e7763
TG
2203 help
2204 Enable this option to test the rhashtable functions at boot.
2205
2206 If unsure, say N.
2207
468a9428
GS
2208config TEST_HASH
2209 tristate "Perform selftest on hash functions"
468a9428 2210 help
2c956a60
JD
2211 Enable this option to test the kernel's integer (<linux/hash.h>),
2212 string (<linux/stringhash.h>), and siphash (<linux/siphash.h>)
2213 hash functions on boot (or module load).
468a9428
GS
2214
2215 This is intended to help people writing architecture-specific
2216 optimized versions. If unsure, say N.
2217
8ab8ba38
MW
2218config TEST_IDA
2219 tristate "Perform selftest on IDA functions"
2220
44091d29
JP
2221config TEST_PARMAN
2222 tristate "Perform selftest on priority array manager"
44091d29
JP
2223 depends on PARMAN
2224 help
2225 Enable this option to test priority array manager on boot
2226 (or module load).
2227
2228 If unsure, say N.
2229
6aed82de
DL
2230config TEST_IRQ_TIMINGS
2231 bool "IRQ timings selftest"
2232 depends on IRQ_TIMINGS
2233 help
2234 Enable this option to test the irq timings code on boot.
2235
2236 If unsure, say N.
2237
8a6f0b47 2238config TEST_LKM
93e9ef83 2239 tristate "Test module loading with 'hello world' module"
93e9ef83
KC
2240 depends on m
2241 help
2242 This builds the "test_module" module that emits "Hello, world"
2243 on printk when loaded. It is designed to be used for basic
2244 evaluation of the module loading subsystem (for example when
2245 validating module verification). It lacks any extra dependencies,
2246 and will not normally be loaded by the system unless explicitly
2247 requested by name.
2248
2249 If unsure, say N.
2250
c348c163 2251config TEST_BITOPS
6af132f3 2252 tristate "Test module for compilation of bitops operations"
c348c163
JB
2253 depends on m
2254 help
2255 This builds the "test_bitops" module that is much like the
2256 TEST_LKM module except that it does a basic exercise of the
6af132f3
WY
2257 set/clear_bit macros and get_count_order/long to make sure there are
2258 no compiler warnings from C=1 sparse checker or -Wextra
2259 compilations. It has no dependencies and doesn't run or load unless
2260 explicitly requested by name. for example: modprobe test_bitops.
c348c163
JB
2261
2262 If unsure, say N.
2263
3f21a6b7
URS
2264config TEST_VMALLOC
2265 tristate "Test module for stress/performance analysis of vmalloc allocator"
2266 default n
2267 depends on MMU
2268 depends on m
2269 help
2270 This builds the "test_vmalloc" module that should be used for
2271 stress and performance analysis. So, any new change for vmalloc
2272 subsystem can be evaluated from performance and stability point
2273 of view.
2274
2275 If unsure, say N.
2276
3e2a4c18
KC
2277config TEST_USER_COPY
2278 tristate "Test user/kernel boundary protections"
3e2a4c18
KC
2279 depends on m
2280 help
2281 This builds the "test_user_copy" module that runs sanity checks
2282 on the copy_to/from_user infrastructure, making sure basic
2283 user/kernel boundary testing is working. If it fails to load,
2284 a regression has been detected in the user/kernel memory boundary
2285 protections.
2286
2287 If unsure, say N.
2288
64a8946b
AS
2289config TEST_BPF
2290 tristate "Test BPF filter functionality"
98920ba6 2291 depends on m && NET
64a8946b
AS
2292 help
2293 This builds the "test_bpf" module that runs various test vectors
2294 against the BPF interpreter or BPF JIT compiler depending on the
2295 current setting. This is in particular useful for BPF JIT compiler
2296 development, but also to run regression tests against changes in
3c731eba
AS
2297 the interpreter code. It also enables test stubs for eBPF maps and
2298 verifier used by user space verifier testsuite.
64a8946b
AS
2299
2300 If unsure, say N.
2301
509e56b3
MB
2302config TEST_BLACKHOLE_DEV
2303 tristate "Test blackhole netdev functionality"
2304 depends on m && NET
2305 help
2306 This builds the "test_blackhole_dev" module that validates the
2307 data path through this blackhole netdev.
2308
2309 If unsure, say N.
2310
dceeb3e7 2311config FIND_BIT_BENCHMARK
4441fca0 2312 tristate "Test find_bit functions"
4441fca0
YN
2313 help
2314 This builds the "test_find_bit" module that measure find_*_bit()
2315 functions performance.
2316
2317 If unsure, say N.
2318
0a8adf58
KC
2319config TEST_FIRMWARE
2320 tristate "Test firmware loading via userspace interface"
0a8adf58
KC
2321 depends on FW_LOADER
2322 help
2323 This builds the "test_firmware" module that creates a userspace
2324 interface for testing firmware loading. This can be used to
2325 control the triggering of firmware loading without needing an
2326 actual firmware-using device. The contents can be rechecked by
2327 userspace.
2328
2329 If unsure, say N.
2330
9308f2f9
LR
2331config TEST_SYSCTL
2332 tristate "sysctl test driver"
9308f2f9
LR
2333 depends on PROC_SYSCTL
2334 help
2335 This builds the "test_sysctl" module. This driver enables to test the
2336 proc sysctl interfaces available to drivers safely without affecting
2337 production knobs which might alter system functionality.
2338
2339 If unsure, say N.
2340
d2585f51
VMI
2341config BITFIELD_KUNIT
2342 tristate "KUnit test bitfield functions at runtime"
2343 depends on KUNIT
2344 help
2345 Enable this option to test the bitfield functions at boot.
2346
2347 KUnit tests run during boot and output the results to the debug log
2348 in TAP format (http://testanything.org/). Only useful for kernel devs
2349 running the KUnit test harness, and not intended for inclusion into a
2350 production build.
2351
2352 For more information on KUnit and unit tests in general please refer
2353 to the KUnit documentation in Documentation/dev-tools/kunit/.
2354
2355 If unsure, say N.
2356
5df38ca6
AS
2357config RESOURCE_KUNIT_TEST
2358 tristate "KUnit test for resource API"
2359 depends on KUNIT
2360 help
2361 This builds the resource API unit test.
2362 Tests the logic of API provided by resource.c and ioport.h.
2363 For more information on KUnit and unit tests in general please refer
2364 to the KUnit documentation in Documentation/dev-tools/kunit/.
2365
2366 If unsure, say N.
2367
2cb80dbb 2368config SYSCTL_KUNIT_TEST
5f215aab 2369 tristate "KUnit test for sysctl" if !KUNIT_ALL_TESTS
2cb80dbb 2370 depends on KUNIT
5f215aab 2371 default KUNIT_ALL_TESTS
2cb80dbb
IZ
2372 help
2373 This builds the proc sysctl unit test, which runs on boot.
2374 Tests the API contract and implementation correctness of sysctl.
2375 For more information on KUnit and unit tests in general please refer
2376 to the KUnit documentation in Documentation/dev-tools/kunit/.
2377
2378 If unsure, say N.
2379
ea2dd7c0 2380config LIST_KUNIT_TEST
5f215aab 2381 tristate "KUnit Test for Kernel Linked-list structures" if !KUNIT_ALL_TESTS
ea2dd7c0 2382 depends on KUNIT
5f215aab 2383 default KUNIT_ALL_TESTS
ea2dd7c0
DG
2384 help
2385 This builds the linked list KUnit test suite.
2386 It tests that the API and basic functionality of the list_head type
2387 and associated macros.
2388
2389 KUnit tests run during boot and output the results to the debug log
d89775fc 2390 in TAP format (https://testanything.org/). Only useful for kernel devs
ea2dd7c0
DG
2391 running the KUnit test harness, and not intended for inclusion into a
2392 production build.
2393
2394 For more information on KUnit and unit tests in general please refer
2395 to the KUnit documentation in Documentation/dev-tools/kunit/.
2396
2397 If unsure, say N.
2398
33d599f0
MV
2399config LINEAR_RANGES_TEST
2400 tristate "KUnit test for linear_ranges"
2401 depends on KUNIT
2402 select LINEAR_RANGES
2403 help
2404 This builds the linear_ranges unit test, which runs on boot.
2405 Tests the linear_ranges logic correctness.
2406 For more information on KUnit and unit tests in general please refer
7546861a
AS
2407 to the KUnit documentation in Documentation/dev-tools/kunit/.
2408
2409 If unsure, say N.
2410
2411config CMDLINE_KUNIT_TEST
2412 tristate "KUnit test for cmdline API"
2413 depends on KUNIT
2414 help
2415 This builds the cmdline API unit test.
2416 Tests the logic of API provided by cmdline.c.
2417 For more information on KUnit and unit tests in general please refer
33d599f0
MV
2418 to the KUnit documentation in Documentation/dev-tools/kunit/.
2419
2420 If unsure, say N.
2421
6d511020
RF
2422config BITS_TEST
2423 tristate "KUnit test for bits.h"
2424 depends on KUNIT
2425 help
2426 This builds the bits unit test.
2427 Tests the logic of macros defined in bits.h.
2428 For more information on KUnit and unit tests in general please refer
2429 to the KUnit documentation in Documentation/dev-tools/kunit/.
2430
2431 If unsure, say N.
2432
1f9f78b1
OG
2433config SLUB_KUNIT_TEST
2434 tristate "KUnit test for SLUB cache error detection" if !KUNIT_ALL_TESTS
2435 depends on SLUB_DEBUG && KUNIT
2436 default KUNIT_ALL_TESTS
2437 help
2438 This builds SLUB allocator unit test.
2439 Tests SLUB cache debugging functionality.
2440 For more information on KUnit and unit tests in general please refer
2441 to the KUnit documentation in Documentation/dev-tools/kunit/.
2442
2443 If unsure, say N.
2444
b6c75c4a
TP
2445config RATIONAL_KUNIT_TEST
2446 tristate "KUnit test for rational.c" if !KUNIT_ALL_TESTS
8ba739ed 2447 depends on KUNIT && RATIONAL
b6c75c4a
TP
2448 default KUNIT_ALL_TESTS
2449 help
2450 This builds the rational math unit test.
2451 For more information on KUnit and unit tests in general please refer
2452 to the KUnit documentation in Documentation/dev-tools/kunit/.
2453
2454 If unsure, say N.
2455
bb95ebbe
KC
2456config MEMCPY_KUNIT_TEST
2457 tristate "Test memcpy(), memmove(), and memset() functions at runtime" if !KUNIT_ALL_TESTS
2458 depends on KUNIT
2459 default KUNIT_ALL_TESTS
2460 help
2461 Builds unit tests for memcpy(), memmove(), and memset() functions.
2462 For more information on KUnit and unit tests in general please refer
2463 to the KUnit documentation in Documentation/dev-tools/kunit/.
2464
2465 If unsure, say N.
2466
e704f93a
DR
2467config TEST_UDELAY
2468 tristate "udelay test driver"
e704f93a
DR
2469 help
2470 This builds the "udelay_test" module that helps to make sure
2471 that udelay() is working properly.
2472
2473 If unsure, say N.
2474
2bf9e0ab
IM
2475config TEST_STATIC_KEYS
2476 tristate "Test static keys"
579e1acb
JB
2477 depends on m
2478 help
2bf9e0ab 2479 Test the static key interfaces.
579e1acb
JB
2480
2481 If unsure, say N.
2482
d9c6a72d
LR
2483config TEST_KMOD
2484 tristate "kmod stress tester"
d9c6a72d 2485 depends on m
d9c6a72d 2486 depends on NETDEVICES && NET_CORE && INET # for TUN
ae3d6a32 2487 depends on BLOCK
d9c6a72d
LR
2488 select TEST_LKM
2489 select XFS_FS
2490 select TUN
2491 select BTRFS_FS
2492 help
2493 Test the kernel's module loading mechanism: kmod. kmod implements
2494 support to load modules using the Linux kernel's usermode helper.
2495 This test provides a series of tests against kmod.
2496
2497 Although technically you can either build test_kmod as a module or
2498 into the kernel we disallow building it into the kernel since
2499 it stress tests request_module() and this will very likely cause
2500 some issues by taking over precious threads available from other
2501 module load requests, ultimately this could be fatal.
2502
2503 To run tests run:
2504
2505 tools/testing/selftests/kmod/kmod.sh --help
2506
2507 If unsure, say N.
2508
e4dace36
FF
2509config TEST_DEBUG_VIRTUAL
2510 tristate "Test CONFIG_DEBUG_VIRTUAL feature"
2511 depends on DEBUG_VIRTUAL
2512 help
2513 Test the kernel's ability to detect incorrect calls to
2514 virt_to_phys() done against the non-linear part of the
2515 kernel's virtual address map.
2516
2517 If unsure, say N.
2518
ce76d938
AS
2519config TEST_MEMCAT_P
2520 tristate "Test memcat_p() helper function"
2521 help
2522 Test the memcat_p() helper for correctly merging two
2523 pointer arrays together.
2524
2525 If unsure, say N.
2526
a2818ee4
JL
2527config TEST_LIVEPATCH
2528 tristate "Test livepatching"
2529 default n
bae05437 2530 depends on DYNAMIC_DEBUG
a2818ee4
JL
2531 depends on LIVEPATCH
2532 depends on m
2533 help
2534 Test kernel livepatching features for correctness. The tests will
2535 load test modules that will be livepatched in various scenarios.
2536
2537 To run all the livepatching tests:
2538
2539 make -C tools/testing/selftests TARGETS=livepatch run_tests
2540
2541 Alternatively, individual tests may be invoked:
2542
2543 tools/testing/selftests/livepatch/test-callbacks.sh
2544 tools/testing/selftests/livepatch/test-livepatch.sh
2545 tools/testing/selftests/livepatch/test-shadow-vars.sh
2546
2547 If unsure, say N.
2548
0a020d41
JP
2549config TEST_OBJAGG
2550 tristate "Perform selftest on object aggreration manager"
2551 default n
2552 depends on OBJAGG
2553 help
2554 Enable this option to test object aggregation manager on boot
2555 (or module load).
2556
0a020d41 2557
50ceaa95
KC
2558config TEST_STACKINIT
2559 tristate "Test level of stack variable initialization"
2560 help
2561 Test if the kernel is zero-initializing stack variables and
2562 padding. Coverage is controlled by compiler flags,
2563 CONFIG_GCC_PLUGIN_STRUCTLEAK, CONFIG_GCC_PLUGIN_STRUCTLEAK_BYREF,
2564 or CONFIG_GCC_PLUGIN_STRUCTLEAK_BYREF_ALL.
2565
2566 If unsure, say N.
2567
5015a300
AP
2568config TEST_MEMINIT
2569 tristate "Test heap/page initialization"
2570 help
2571 Test if the kernel is zero-initializing heap and page allocations.
2572 This can be useful to test init_on_alloc and init_on_free features.
2573
2574 If unsure, say N.
2575
b2ef9f5a
RC
2576config TEST_HMM
2577 tristate "Test HMM (Heterogeneous Memory Management)"
2578 depends on TRANSPARENT_HUGEPAGE
2579 depends on DEVICE_PRIVATE
2580 select HMM_MIRROR
2581 select MMU_NOTIFIER
2582 help
2583 This is a pseudo device driver solely for testing HMM.
2584 Say M here if you want to build the HMM test module.
2585 Doing so will allow you to run tools/testing/selftest/vm/hmm-tests.
2586
2587 If unsure, say N.
2588
e320d301
MWO
2589config TEST_FREE_PAGES
2590 tristate "Test freeing pages"
2591 help
2592 Test that a memory leak does not occur due to a race between
2593 freeing a block of pages and a speculative page reference.
2594 Loading this module is safe if your kernel has the bug fixed.
2595 If the bug is not fixed, it will leak gigabytes of memory and
2596 probably OOM your system.
2597
4185b3b9
PA
2598config TEST_FPU
2599 tristate "Test floating point operations in kernel space"
2600 depends on X86 && !KCOV_INSTRUMENT_ALL
2601 help
2602 Enable this option to add /sys/kernel/debug/selftest_helpers/test_fpu
2603 which will trigger a sequence of floating point operations. This is used
2604 for self-testing floating point control register setting in
2605 kernel_fpu_begin().
2606
2607 If unsure, say N.
2608
1253b9b8
PM
2609config TEST_CLOCKSOURCE_WATCHDOG
2610 tristate "Test clocksource watchdog in kernel space"
2611 depends on CLOCKSOURCE_WATCHDOG
2612 help
2613 Enable this option to create a kernel module that will trigger
2614 a test of the clocksource watchdog. This module may be loaded
2615 via modprobe or insmod in which case it will run upon being
2616 loaded, or it may be built in, in which case it will run
2617 shortly after boot.
2618
2619 If unsure, say N.
2620
d3deafaa 2621endif # RUNTIME_TESTING_MENU
cc3fa840 2622
dce44566
AK
2623config ARCH_USE_MEMTEST
2624 bool
2625 help
2626 An architecture should select this when it uses early_memtest()
2627 during boot process.
2628
cc3fa840
RD
2629config MEMTEST
2630 bool "Memtest"
dce44566 2631 depends on ARCH_USE_MEMTEST
a7f7f624 2632 help
cc3fa840 2633 This option adds a kernel parameter 'memtest', which allows memtest
dce44566 2634 to be set and executed.
cc3fa840
RD
2635 memtest=0, mean disabled; -- default
2636 memtest=1, mean do 1 test pattern;
2637 ...
2638 memtest=17, mean do 17 test patterns.
2639 If you are unsure how to answer this question, answer N.
2640
21266be9 2641
06ec64b8 2642
af9ca6f9
BB
2643config HYPERV_TESTING
2644 bool "Microsoft Hyper-V driver testing"
2645 default n
2646 depends on HYPERV && DEBUG_FS
2647 help
2648 Select this option to enable Hyper-V vmbus testing.
2649
045f6d79
CD
2650endmenu # "Kernel Testing and Coverage"
2651
75442fb0
MCC
2652source "Documentation/Kconfig"
2653
06ec64b8 2654endmenu # Kernel hacking