lib/Kconfig.debug

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