arch/x86/Kconfig.debug

   1 # SPDX-License-Identifier: GPL-2.0
   2
   3 config TRACE_IRQFLAGS_NMI_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 EFI_PGT_DUMP
  63         bool "Dump the EFI pagetable"
  64         depends on EFI
  65         select PTDUMP_CORE
  66         help
  67           Enable this if you want to dump the EFI page table before
  68           enabling virtual mode. This can be used to debug miscellaneous
  69           issues with the mapping of the EFI runtime regions into that
  70           table.
  71
  72 config DEBUG_TLBFLUSH
  73         bool "Set upper limit of TLB entries to flush one-by-one"
  74         depends on DEBUG_KERNEL
  75         help
  76           X86-only for now.
  77
  78           This option allows the user to tune the amount of TLB entries the
  79           kernel flushes one-by-one instead of doing a full TLB flush. In
  80           certain situations, the former is cheaper. This is controlled by the
  81           tlb_flushall_shift knob under /sys/kernel/debug/x86. If you set it
  82           to -1, the code flushes the whole TLB unconditionally. Otherwise,
  83           for positive values of it, the kernel will use single TLB entry
  84           invalidating instructions according to the following formula:
  85
  86           flush_entries <= active_tlb_entries / 2^tlb_flushall_shift
  87
  88           If in doubt, say "N".
  89
  90 config IOMMU_DEBUG
  91         bool "Enable IOMMU debugging"
  92         depends on GART_IOMMU && DEBUG_KERNEL
  93         depends on X86_64
  94         help
  95           Force the IOMMU to on even when you have less than 4GB of
  96           memory and add debugging code. On overflow always panic. And
  97           allow to enable IOMMU leak tracing. Can be disabled at boot
  98           time with iommu=noforce. This will also enable scatter gather
  99           list merging.  Currently not recommended for production
 100           code. When you use it make sure you have a big enough
 101           IOMMU/AGP aperture.  Most of the options enabled by this can
 102           be set more finegrained using the iommu= command line
 103           options. See Documentation/x86/x86_64/boot-options.rst for more
 104           details.
 105
 106 config IOMMU_LEAK
 107         bool "IOMMU leak tracing"
 108         depends on IOMMU_DEBUG && DMA_API_DEBUG
 109         help
 110           Add a simple leak tracer to the IOMMU code. This is useful when you
 111           are debugging a buggy device driver that leaks IOMMU mappings.
 112
 113 config HAVE_MMIOTRACE_SUPPORT
 114         def_bool y
 115
 116 config X86_DECODER_SELFTEST
 117         bool "x86 instruction decoder selftest"
 118         depends on DEBUG_KERNEL && INSTRUCTION_DECODER
 119         depends on !COMPILE_TEST
 120         help
 121           Perform x86 instruction decoder selftests at build time.
 122           This option is useful for checking the sanity of x86 instruction
 123           decoder code.
 124           If unsure, say "N".
 125
 126 choice
 127         prompt "IO delay type"
 128         default IO_DELAY_0X80
 129
 130 config IO_DELAY_0X80
 131         bool "port 0x80 based port-IO delay [recommended]"
 132         help
 133           This is the traditional Linux IO delay used for in/out_p.
 134           It is the most tested hence safest selection here.
 135
 136 config IO_DELAY_0XED
 137         bool "port 0xed based port-IO delay"
 138         help
 139           Use port 0xed as the IO delay. This frees up port 0x80 which is
 140           often used as a hardware-debug port.
 141
 142 config IO_DELAY_UDELAY
 143         bool "udelay based port-IO delay"
 144         help
 145           Use udelay(2) as the IO delay method. This provides the delay
 146           while not having any side-effect on the IO port space.
 147
 148 config IO_DELAY_NONE
 149         bool "no port-IO delay"
 150         help
 151           No port-IO delay. Will break on old boxes that require port-IO
 152           delay for certain operations. Should work on most new machines.
 153
 154 endchoice
 155
 156 config DEBUG_BOOT_PARAMS
 157         bool "Debug boot parameters"
 158         depends on DEBUG_KERNEL
 159         depends on DEBUG_FS
 160         help
 161           This option will cause struct boot_params to be exported via debugfs.
 162
 163 config CPA_DEBUG
 164         bool "CPA self-test code"
 165         depends on DEBUG_KERNEL
 166         help
 167           Do change_page_attr() self-tests every 30 seconds.
 168
 169 config DEBUG_ENTRY
 170         bool "Debug low-level entry code"
 171         depends on DEBUG_KERNEL
 172         help
 173           This option enables sanity checks in x86's low-level entry code.
 174           Some of these sanity checks may slow down kernel entries and
 175           exits or otherwise impact performance.
 176
 177           If unsure, say N.
 178
 179 config DEBUG_NMI_SELFTEST
 180         bool "NMI Selftest"
 181         depends on DEBUG_KERNEL && X86_LOCAL_APIC
 182         help
 183           Enabling this option turns on a quick NMI selftest to verify
 184           that the NMI behaves correctly.
 185
 186           This might help diagnose strange hangs that rely on NMI to
 187           function properly.
 188
 189           If unsure, say N.
 190
 191 config DEBUG_IMR_SELFTEST
 192         bool "Isolated Memory Region self test"
 193         depends on INTEL_IMR
 194         help
 195           This option enables automated sanity testing of the IMR code.
 196           Some simple tests are run to verify IMR bounds checking, alignment
 197           and overlapping. This option is really only useful if you are
 198           debugging an IMR memory map or are modifying the IMR code and want to
 199           test your changes.
 200
 201           If unsure say N here.
 202
 203 config X86_DEBUG_FPU
 204         bool "Debug the x86 FPU code"
 205         depends on DEBUG_KERNEL
 206         default y
 207         help
 208           If this option is enabled then there will be extra sanity
 209           checks and (boot time) debug printouts added to the kernel.
 210           This debugging adds some small amount of runtime overhead
 211           to the kernel.
 212
 213           If unsure, say N.
 214
 215 config PUNIT_ATOM_DEBUG
 216         tristate "ATOM Punit debug driver"
 217         depends on PCI
 218         select DEBUG_FS
 219         select IOSF_MBI
 220         help
 221           This is a debug driver, which gets the power states
 222           of all Punit North Complex devices. The power states of
 223           each device is exposed as part of the debugfs interface.
 224           The current power state can be read from
 225           /sys/kernel/debug/punit_atom/dev_power_state
 226
 227 choice
 228         prompt "Choose kernel unwinder"
 229         default UNWINDER_ORC if X86_64
 230         default UNWINDER_FRAME_POINTER if X86_32
 231         help
 232           This determines which method will be used for unwinding kernel stack
 233           traces for panics, oopses, bugs, warnings, perf, /proc/<pid>/stack,
 234           livepatch, lockdep, and more.
 235
 236 config UNWINDER_ORC
 237         bool "ORC unwinder"
 238         depends on X86_64
 239         select OBJTOOL
 240         help
 241           This option enables the ORC (Oops Rewind Capability) unwinder for
 242           unwinding kernel stack traces.  It uses a custom data format which is
 243           a simplified version of the DWARF Call Frame Information standard.
 244
 245           This unwinder is more accurate across interrupt entry frames than the
 246           frame pointer unwinder.  It also enables a 5-10% performance
 247           improvement across the entire kernel compared to frame pointers.
 248
 249           Enabling this option will increase the kernel's runtime memory usage
 250           by roughly 2-4MB, depending on your kernel config.
 251
 252 config UNWINDER_FRAME_POINTER
 253         bool "Frame pointer unwinder"
 254         select FRAME_POINTER
 255         help
 256           This option enables the frame pointer unwinder for unwinding kernel
 257           stack traces.
 258
 259           The unwinder itself is fast and it uses less RAM than the ORC
 260           unwinder, but the kernel text size will grow by ~3% and the kernel's
 261           overall performance will degrade by roughly 5-10%.
 262
 263 config UNWINDER_GUESS
 264         bool "Guess unwinder"
 265         depends on EXPERT
 266         depends on !STACKDEPOT
 267         help
 268           This option enables the "guess" unwinder for unwinding kernel stack
 269           traces.  It scans the stack and reports every kernel text address it
 270           finds.  Some of the addresses it reports may be incorrect.
 271
 272           While this option often produces false positives, it can still be
 273           useful in many cases.  Unlike the other unwinders, it has no runtime
 274           overhead.
 275
 276 endchoice
 277
 278 config FRAME_POINTER
 279         depends on !UNWINDER_ORC && !UNWINDER_GUESS
 280         bool