linux-6.8/lib/Kconfig.debug

1 # SPDX-License-Identifier: GPL-2.0-only
19 	  parameter printk.time=1. See Documentation/admin-guide/kernel-parameters.rst
50 	int "Default console loglevel (1-15)"
60 	  Note: This does not affect the log level of un-prefixed printk()
65 	int "quiet console loglevel (1-15)"
76 	int "Default message log level (1-7)"
82 	  This was hard-coded to KERN_WARNING since at least 2.6.10 but folks
118 	  enabled/disabled based on various levels of scope - per source file,
158 		nullarbor:~ # echo -n 'file svcsock.c line 1603 +p' >
162 		nullarbor:~ # echo -n 'file svcsock.c +p' >
166 		nullarbor:~ # echo -n 'module nfsd +p' >
170 		nullarbor:~ # echo -n 'func svc_process +p' >
174 		nullarbor:~ # echo -n 'func svc_process -p' >
177 	  See Documentation/admin-guide/dynamic-debug-howto.rst for additional
207 	  debugging but costs about 70-100K of memory.
225 menu "Compile-time checks and compiler options"
235 # older binutils ports do not support when utilizing RISC-V style linker
238 	def_bool $(as-instr,.uleb128 .Lexpr_end4 - .Lexpr_start3\n.Lexpr_start3:\n.Lexpr_end4:)
246 	  This adds debug symbols to the kernel and modules (gcc -g), and
290 	  5.0+ accepts the -gdwarf-5 flag but only had partial support for some
294 	  15-18% savings in resulting image and debug info section sizes as
332 	depends on $(cc-option,-gz=zlib)
333 	depends on $(ld-option,--compress-debug-sections=zlib)
338 	  Users of dpkg-deb via scripts/package/builddeb may find an increase in
347 	depends on $(cc-option,-gz=zstd)
348 	depends on $(ld-option,--compress-debug-sections=zstd)
359 	depends on $(cc-option,-gsplit-dwarf)
360 	# RISC-V linker relaxation + -gsplit-dwarf has issues with LLVM and GCC
362 	# https://github.com/llvm/llvm-project/issues/56642
404 	  Support for the --lang_exclude flag which makes pahole exclude
417 	bool "Allow loading modules with non-matching BTF type info"
433 	  instance. See Documentation/dev-tools/gdb-kernel-debugging.rst
454 	bool "Strip assembler-generated symbols during link"
457 	  Strip internal assembler-generated symbols during a link (symbols
475 	  This option will install uapi headers (headers exported to user-space)
478 	  user-space program samples. It is also needed by some features such
496 	  - Add the option -fno-inline-functions-called-once to gcc commands.
497 	    When inlining a function annotated with __init in a non-init
504 	bool "Make section mismatch errors non-fatal"
546 	bool "Compile-time stack metadata validation"
551 	  Validate frame pointer rules at compile-time.  This helps ensure that
567 	  Selecting this option will pass "-Map=vmlinux.map" to ld
574 	bool "Force weak per-cpu definitions"
603 	  keys are documented in <file:Documentation/admin-guide/sysrq.rst>.
613 	  to a bitmask as described in Documentation/admin-guide/sysrq.rst.
654 	  debugfs=[on,no-mount,off]. The restrictions apply for API access
673 	  Access is off. Clients get -PERM when trying to create nodes in
675 	  Client can then back-off or continue without debugfs access.
715 	  properly. This can make kmalloc/kfree-intensive workloads
749 	int "debug_objects bootup default value (0-1)"
769 	  task has ever had available in the sysrq-T and sysrq-P debug output.
800 	  Enable this to turn on extended checks in the virtual-memory system
825 	bool "Debug VM red-black trees"
828 	  Enable VM red-black tree debugging information and extra validations.
833 	bool "Debug page-flags operations"
883 	  on the mminit_loglevel= command-line option.
891 	  This option provides the ability to inject artificial errors to
893 	  debugfs interface under /sys/kernel/debug/notifier-error-inject/memory
898 	  Example: Inject memory hotplug offline error (-12 == -ENOMEM)
900 	  # cd /sys/kernel/debug/notifier-error-inject/memory
901 	  # echo -12 > actions/MEM_GOING_OFFLINE/error
906 	  be called memory-notifier-error-inject.
938 	  mechanism for non-highmem pages and on non-highmem systems.
962 	  These kinds of bugs usually occur when call-chains in the
1044 	  high-availability systems that have uptime guarantees and
1083 # Note that arch-specific variants are always preferred.
1098 	  an arch-specific hardlockup detector or if resources needed
1121 	  The arch-specific implementation of the hardlockup detector will
1171 	  to determine when a task has become non-responsive and should
1192 	  high-availability systems that have uptime guarantees and
1209 	bool "Report per-cpu work items which hog CPU for too long"
1212 	  Say Y here to enable reporting of concurrency-managed per-cpu work
1216 	  them from stalling other per-cpu work items. Occassional
1230 	  Also it could generate series of lockups with cooling-down periods.
1285 	  if kernel code uses it in a preemption-unsafe way. Also, the kernel
1326 	 participant CPUs, tasks and irq-contexts would be needed
1339 	 and rwsems - in which case all dependencies between these
1344 	 For more details, see Documentation/locking/lockdep-design.rst.
1347 	bool "Enable raw_spinlock - spinlock nesting checks"
1393 	bool "Spinlock and rw-lock debugging: basic checks"
1418 	 injecting additional -EDEADLK wound/backoff cases. Together with
1444 	 memory-freeing routines (kfree(), kmem_cache_free(), free_pages(),
1497 … Try increasing this value if you hit "lockdep bfs error:-1" warning due to __cq_enqueue() failure.
1520 	bool "Locking API boot-time self-tests"
1523 	  Say Y here if you want the kernel to run a short self-test during
1524 	  bootup. The self-test checks whether common types of locking bugs
1539 	  Say Y here if you want kernel locking-primitive torture tests
1690 	  Enable this to turn on extended checks in the linked-list walking
1703 	  Enable this to turn on extended checks in the priority-ordered
1704 	  linked-list (plist) walking routines.  This checks the entire
1713 	  Enable this to turn on checks on scatter-gather tables. This can
1751 	bool "Force round-robin CPU selection for unbound work items"
1760 	  round-robin CPU selection to flush out usages which depend on the
1829 	  in charge of the OHCI-1394 controllers should be used instead.
1831 	  See Documentation/core-api/debugging-via-ohci1394.rst for more information.
1863 	  io-memory regardless of whether a driver is actively using that
1868 	  userspace access to *idle* io-memory ranges (see /proc/iomem) This
1889 	  This option provides the ability to inject artificial errors to
1900 	  This option provides the ability to inject artificial errors to
1902 	  interface /sys/kernel/debug/notifier-error-inject/pm
1907 	  Example: Inject PM suspend error (-12 = -ENOMEM)
1909 	  # cd /sys/kernel/debug/notifier-error-inject/pm/
1910 	  # echo -12 > actions/PM_SUSPEND_PREPARE/error
1915 	  be called pm-notifier-error-inject.
1923 	  This option provides the ability to inject artificial errors to
1926 	  /sys/kernel/debug/notifier-error-inject/OF-reconfig/
1932 	  be called of-reconfig-notifier-error-inject.
1940 	  This option provides the ability to inject artificial errors to
1942 	  interface /sys/kernel/debug/notifier-error-inject/netdev
1947 	  Example: Inject netdevice mtu change error (-22 = -EINVAL)
1949 	  # cd /sys/kernel/debug/notifier-error-inject/netdev
1950 	  # echo -22 > actions/NETDEV_CHANGEMTU/error
1955 	  be called netdev-notifier-error-inject.
1960 	bool "Fault-injections of functions"
1963 	  Add fault injections into various functions that are annotated with
1970 	bool "Fault-injection framework"
1973 	  Provide fault-injection framework.
1974 	  For more details, see Documentation/fault-injection/.
1977 	bool "Fault-injection capability for kmalloc"
1980 	  Provide fault-injection capability for kmalloc.
1983 	bool "Fault-injection capability for alloc_pages()"
1986 	  Provide fault-injection capability for alloc_pages().
1989 	bool "Fault injection capability for usercopy functions"
1992 	  Provides fault-injection capability to inject failures
1996 	bool "Fault-injection capability for disk IO"
1999 	  Provide fault-injection capability for disk IO.
2002 	bool "Fault-injection capability for faking disk interrupts"
2005 	  Provide fault-injection capability on end IO handling. This
2013 	bool "Fault-injection capability for futexes"
2017 	  Provide fault-injection capability for futexes.
2020 	bool "Debugfs entries for fault-injection capabilities"
2023 	  Enable configuration of fault-injection capabilities via debugfs.
2026 	bool "Fault-injection capability for functions"
2029 	  Provide function-based fault-injection capability.
2036 	bool "Fault-injection capability for MMC IO"
2039 	  Provide fault-injection capability for MMC IO.
2046 	bool "Fault-injection capability for SunRPC"
2049 	  Provide fault-injection capability for SunRPC and
2053 	bool "Configfs interface for fault-injection capabilities"
2057 	  This option allows configfs-based drivers to dynamically configure
2058 	  fault-injection via configfs.  Each parameter for driver-specific
2059 	  fault-injection can be made visible as a configfs attribute in a
2064 	bool "stacktrace filter for fault-injection capabilities"
2070 	  Provide stacktrace filter for fault-injection capabilities
2080 	def_bool $(cc-option,-fsanitize-coverage=trace-pc)
2094 	  for coverage-guided fuzzing (randomized testing).
2096 	  For more details, see Documentation/dev-tools/kcov.rst.
2101 	depends on $(cc-option,-fsanitize-coverage=trace-cmp)
2124 	  KCOV uses preallocated per-cpu areas to collect coverage from
2144 	  the kernel command line (when built-in), or from userspace (when
2145 	  built-in or modular.
2180 	Documentation/fault-injection/provoke-crashes.rst
2190 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2216 	tristate "Array-based sort test" if !KUNIT_ALL_TESTS
2220 	  This option enables the self-test function of 'sort()' at boot,
2298 	tristate "Red-Black tree test"
2305 	tristate "Reed-Solomon library test"
2311 	  This option enables the self-test function of rslib at boot,
2327 	  Enable this option to build test module which validates per-cpu
2333 	tristate "Perform an atomic64_t self-test"
2345 	  This is a one-shot self test that permutes through the
2347 	  N-disk array.  Recovery is performed with the asynchronous
2440 	  no compiler warnings from C=1 sparse checker or -Wextra
2508 	  actual firmware-using device. The contents can be rechecked by
2536 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2553 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2571 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2573 	  This is intended to help people writing architecture-specific
2584 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2596 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2601 	tristate "KUnit Test for Kernel Linked-list structures" if !KUNIT_ALL_TESTS
2615 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2628 	  in Documentation/dev-tools/kunit/.
2640 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2652 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2664 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2676 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2687 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2698 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2722 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2735 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
2744 	  Test if the kernel is zero-initializing stack variables and
2787 	  This is intended to help people writing architecture-specific
2839 	  tools/testing/selftests/kmod/kmod.sh --help
2848 	  virt_to_phys() done against the non-linear part of the
2873 	  make -C tools/testing/selftests TARGETS=livepatch run_tests
2877 	  tools/testing/selftests/livepatch/test-callbacks.sh
2878 	  tools/testing/selftests/livepatch/test-livepatch.sh
2879 	  tools/testing/selftests/livepatch/test-shadow-vars.sh
2894 	  Test if the kernel is zero-initializing heap and page allocations.
2908 	  Doing so will allow you to run tools/testing/selftest/vm/hmm-tests.
2927 	  for self-testing floating point control register setting in
2969 	        memtest=0, mean disabled; -- default
2978 	bool "Microsoft Hyper-V driver testing"
2982 	  Select this option to enable Hyper-V vmbus testing.
2992 	  Enables rustc's `-Cdebug-assertions` codegen option.
3008 	  Enables rustc's `-Coverflow-checks` codegen option.
3011 	  overflow. When overflow-checks are enabled, a Rust panic will occur
3019 	bool "Allow unoptimized build-time assertions"
3043 	  please refer to the KUnit documentation in Documentation/dev-tools/kunit/.