arch/x86/Kconfig.debug

   1 # SPDX-License-Identifier: GPL-2.0
   2
   3 config TRACE_IRQFLAGS_SUPPORT
   4         def_bool y
   5
   6 config EARLY_PRINTK_USB
   7         bool
   8
   9 config X86_VERBOSE_BOOTUP
  10         bool "Enable verbose x86 bootup info messages"
  11         default y
  12         ---help---
  13           Enables the informational output from the decompression stage
  14           (e.g. bzImage) of the boot. If you disable this you will still
  15           see errors. Disable this if you want silent bootup.
  16
  17 config EARLY_PRINTK
  18         bool "Early printk" if EXPERT
  19         default y
  20         ---help---
  21           Write kernel log output directly into the VGA buffer or to a serial
  22           port.
  23
  24           This is useful for kernel debugging when your machine crashes very
  25           early before the console code is initialized. For normal operation
  26           it is not recommended because it looks ugly and doesn't cooperate
  27           with klogd/syslogd or the X server. You should normally say N here,
  28           unless you want to debug such a crash.
  29
  30 config EARLY_PRINTK_DBGP
  31         bool "Early printk via EHCI debug port"
  32         depends on EARLY_PRINTK && PCI
  33         select EARLY_PRINTK_USB
  34         ---help---
  35           Write kernel log output directly into the EHCI debug port.
  36
  37           This is useful for kernel debugging when your machine crashes very
  38           early before the console code is initialized. For normal operation
  39           it is not recommended because it looks ugly and doesn't cooperate
  40           with klogd/syslogd or the X server. You should normally say N here,
  41           unless you want to debug such a crash. You need usb debug device.
  42
  43 config EARLY_PRINTK_USB_XDBC
  44         bool "Early printk via the xHCI debug port"
  45         depends on EARLY_PRINTK && PCI
  46         select EARLY_PRINTK_USB
  47         ---help---
  48           Write kernel log output directly into the xHCI debug port.
  49
  50           One use for this feature is kernel debugging, for example when your
  51           machine crashes very early before the regular console code is
  52           initialized. Other uses include simpler, lockless logging instead of
  53           a full-blown printk console driver + klogd.
  54
  55           For normal production environments this is normally not recommended,
  56           because it doesn't feed events into klogd/syslogd and doesn't try to
  57           print anything on the screen.
  58
  59           You should normally say N here, unless you want to debug early
  60           crashes or need a very simple printk logging facility.
  61
  62 config MCSAFE_TEST
  63         def_bool n
  64
  65 config EFI_PGT_DUMP
  66         bool "Dump the EFI pagetable"
  67         depends on EFI
  68         select PTDUMP_CORE
  69         ---help---
  70           Enable this if you want to dump the EFI page table before
  71           enabling virtual mode. This can be used to debug miscellaneous
  72           issues with the mapping of the EFI runtime regions into that
  73           table.
  74
  75 config DEBUG_WX
  76         bool "Warn on W+X mappings at boot"
  77         select PTDUMP_CORE
  78         ---help---
  79           Generate a warning if any W+X mappings are found at boot.
  80
  81           This is useful for discovering cases where the kernel is leaving
  82           W+X mappings after applying NX, as such mappings are a security risk.
  83
  84           Look for a message in dmesg output like this:
  85
  86             x86/mm: Checked W+X mappings: passed, no W+X pages found.
  87
  88           or like this, if the check failed:
  89
  90             x86/mm: Checked W+X mappings: FAILED, <N> W+X pages found.
  91
  92           Note that even if the check fails, your kernel is possibly
  93           still fine, as W+X mappings are not a security hole in
  94           themselves, what they do is that they make the exploitation
  95           of other unfixed kernel bugs easier.
  96
  97           There is no runtime or memory usage effect of this option
  98           once the kernel has booted up - it's a one time check.
  99
 100           If in doubt, say "Y".
 101
 102 config DOUBLEFAULT
 103         default y
 104         bool "Enable doublefault exception handler" if EXPERT && X86_32
 105         ---help---
 106           This option allows trapping of rare doublefault exceptions that
 107           would otherwise cause a system to silently reboot. Disabling this
 108           option saves about 4k and might cause you much additional grey
 109           hair.
 110
 111 config DEBUG_TLBFLUSH
 112         bool "Set upper limit of TLB entries to flush one-by-one"
 113         depends on DEBUG_KERNEL
 114         ---help---
 115
 116         X86-only for now.
 117
 118         This option allows the user to tune the amount of TLB entries the
 119         kernel flushes one-by-one instead of doing a full TLB flush. In
 120         certain situations, the former is cheaper. This is controlled by the
 121         tlb_flushall_shift knob under /sys/kernel/debug/x86. If you set it
 122         to -1, the code flushes the whole TLB unconditionally. Otherwise,
 123         for positive values of it, the kernel will use single TLB entry
 124         invalidating instructions according to the following formula:
 125
 126         flush_entries <= active_tlb_entries / 2^tlb_flushall_shift
 127
 128         If in doubt, say "N".
 129
 130 config IOMMU_DEBUG
 131         bool "Enable IOMMU debugging"
 132         depends on GART_IOMMU && DEBUG_KERNEL
 133         depends on X86_64
 134         ---help---
 135           Force the IOMMU to on even when you have less than 4GB of
 136           memory and add debugging code. On overflow always panic. And
 137           allow to enable IOMMU leak tracing. Can be disabled at boot
 138           time with iommu=noforce. This will also enable scatter gather
 139           list merging.  Currently not recommended for production
 140           code. When you use it make sure you have a big enough
 141           IOMMU/AGP aperture.  Most of the options enabled by this can
 142           be set more finegrained using the iommu= command line
 143           options. See Documentation/x86/x86_64/boot-options.rst for more
 144           details.
 145
 146 config IOMMU_LEAK
 147         bool "IOMMU leak tracing"
 148         depends on IOMMU_DEBUG && DMA_API_DEBUG
 149         ---help---
 150           Add a simple leak tracer to the IOMMU code. This is useful when you
 151           are debugging a buggy device driver that leaks IOMMU mappings.
 152
 153 config HAVE_MMIOTRACE_SUPPORT
 154         def_bool y
 155
 156 config X86_DECODER_SELFTEST
 157         bool "x86 instruction decoder selftest"
 158         depends on DEBUG_KERNEL && INSTRUCTION_DECODER
 159         depends on !COMPILE_TEST
 160         ---help---
 161          Perform x86 instruction decoder selftests at build time.
 162          This option is useful for checking the sanity of x86 instruction
 163          decoder code.
 164          If unsure, say "N".
 165
 166 choice
 167         prompt "IO delay type"
 168         default IO_DELAY_0X80
 169
 170 config IO_DELAY_0X80
 171         bool "port 0x80 based port-IO delay [recommended]"
 172         ---help---
 173           This is the traditional Linux IO delay used for in/out_p.
 174           It is the most tested hence safest selection here.
 175
 176 config IO_DELAY_0XED
 177         bool "port 0xed based port-IO delay"
 178         ---help---
 179           Use port 0xed as the IO delay. This frees up port 0x80 which is
 180           often used as a hardware-debug port.
 181
 182 config IO_DELAY_UDELAY
 183         bool "udelay based port-IO delay"
 184         ---help---
 185           Use udelay(2) as the IO delay method. This provides the delay
 186           while not having any side-effect on the IO port space.
 187
 188 config IO_DELAY_NONE
 189         bool "no port-IO delay"
 190         ---help---
 191           No port-IO delay. Will break on old boxes that require port-IO
 192           delay for certain operations. Should work on most new machines.
 193
 194 endchoice
 195
 196 config DEBUG_BOOT_PARAMS
 197         bool "Debug boot parameters"
 198         depends on DEBUG_KERNEL
 199         depends on DEBUG_FS
 200         ---help---
 201           This option will cause struct boot_params to be exported via debugfs.
 202
 203 config CPA_DEBUG
 204         bool "CPA self-test code"
 205         depends on DEBUG_KERNEL
 206         ---help---
 207           Do change_page_attr() self-tests every 30 seconds.
 208
 209 config DEBUG_ENTRY
 210         bool "Debug low-level entry code"
 211         depends on DEBUG_KERNEL
 212         ---help---
 213           This option enables sanity checks in x86's low-level entry code.
 214           Some of these sanity checks may slow down kernel entries and
 215           exits or otherwise impact performance.
 216
 217           If unsure, say N.
 218
 219 config DEBUG_NMI_SELFTEST
 220         bool "NMI Selftest"
 221         depends on DEBUG_KERNEL && X86_LOCAL_APIC
 222         ---help---
 223           Enabling this option turns on a quick NMI selftest to verify
 224           that the NMI behaves correctly.
 225
 226           This might help diagnose strange hangs that rely on NMI to
 227           function properly.
 228
 229           If unsure, say N.
 230
 231 config DEBUG_IMR_SELFTEST
 232         bool "Isolated Memory Region self test"
 233         depends on INTEL_IMR
 234         ---help---
 235           This option enables automated sanity testing of the IMR code.
 236           Some simple tests are run to verify IMR bounds checking, alignment
 237           and overlapping. This option is really only useful if you are
 238           debugging an IMR memory map or are modifying the IMR code and want to
 239           test your changes.
 240
 241           If unsure say N here.
 242
 243 config X86_DEBUG_FPU
 244         bool "Debug the x86 FPU code"
 245         depends on DEBUG_KERNEL
 246         default y
 247         ---help---
 248           If this option is enabled then there will be extra sanity
 249           checks and (boot time) debug printouts added to the kernel.
 250           This debugging adds some small amount of runtime overhead
 251           to the kernel.
 252
 253           If unsure, say N.
 254
 255 config PUNIT_ATOM_DEBUG
 256         tristate "ATOM Punit debug driver"
 257         depends on PCI
 258         select DEBUG_FS
 259         select IOSF_MBI
 260         ---help---
 261           This is a debug driver, which gets the power states
 262           of all Punit North Complex devices. The power states of
 263           each device is exposed as part of the debugfs interface.
 264           The current power state can be read from
 265           /sys/kernel/debug/punit_atom/dev_power_state
 266
 267 choice
 268         prompt "Choose kernel unwinder"
 269         default UNWINDER_ORC if X86_64
 270         default UNWINDER_FRAME_POINTER if X86_32
 271         ---help---
 272           This determines which method will be used for unwinding kernel stack
 273           traces for panics, oopses, bugs, warnings, perf, /proc/<pid>/stack,
 274           livepatch, lockdep, and more.
 275
 276 config UNWINDER_ORC
 277         bool "ORC unwinder"
 278         depends on X86_64
 279         select STACK_VALIDATION
 280         ---help---
 281           This option enables the ORC (Oops Rewind Capability) unwinder for
 282           unwinding kernel stack traces.  It uses a custom data format which is
 283           a simplified version of the DWARF Call Frame Information standard.
 284
 285           This unwinder is more accurate across interrupt entry frames than the
 286           frame pointer unwinder.  It also enables a 5-10% performance
 287           improvement across the entire kernel compared to frame pointers.
 288
 289           Enabling this option will increase the kernel's runtime memory usage
 290           by roughly 2-4MB, depending on your kernel config.
 291
 292 config UNWINDER_FRAME_POINTER
 293         bool "Frame pointer unwinder"
 294         select FRAME_POINTER
 295         ---help---
 296           This option enables the frame pointer unwinder for unwinding kernel
 297           stack traces.
 298
 299           The unwinder itself is fast and it uses less RAM than the ORC
 300           unwinder, but the kernel text size will grow by ~3% and the kernel's
 301           overall performance will degrade by roughly 5-10%.
 302
 303 config UNWINDER_GUESS
 304         bool "Guess unwinder"
 305         depends on EXPERT
 306         depends on !STACKDEPOT
 307         ---help---
 308           This option enables the "guess" unwinder for unwinding kernel stack
 309           traces.  It scans the stack and reports every kernel text address it
 310           finds.  Some of the addresses it reports may be incorrect.
 311
 312           While this option often produces false positives, it can still be
 313           useful in many cases.  Unlike the other unwinders, it has no runtime
 314           overhead.
 315
 316 endchoice
 317
 318 config FRAME_POINTER
 319         depends on !UNWINDER_ORC && !UNWINDER_GUESS
 320         bool