Documentation/sysctl/kernel.txt

   1 Documentation for /proc/sys/kernel/*    kernel version 2.2.10
   2         (c) 1998, 1999,  Rik van Riel <riel@nl.linux.org>
   3         (c) 2009,        Shen Feng<shen@cn.fujitsu.com>
   4
   5 For general info and legal blurb, please look in README.
   6
   7 ==============================================================
   8
   9 This file contains documentation for the sysctl files in
  10 /proc/sys/kernel/ and is valid for Linux kernel version 2.2.
  11
  12 The files in this directory can be used to tune and monitor
  13 miscellaneous and general things in the operation of the Linux
  14 kernel. Since some of the files _can_ be used to screw up your
  15 system, it is advisable to read both documentation and source
  16 before actually making adjustments.
  17
  18 Currently, these files might (depending on your configuration)
  19 show up in /proc/sys/kernel:
  20 - acpi_video_flags
  21 - acct
  22 - callhome                   [ S390 only ]
  23 - auto_msgmni
  24 - core_pattern
  25 - core_uses_pid
  26 - ctrl-alt-del
  27 - dentry-state
  28 - domainname
  29 - hostname
  30 - hotplug
  31 - java-appletviewer           [ binfmt_java, obsolete ]
  32 - java-interpreter            [ binfmt_java, obsolete ]
  33 - kstack_depth_to_print       [ X86 only ]
  34 - l2cr                        [ PPC only ]
  35 - modprobe                    ==> Documentation/debugging-modules.txt
  36 - modules_disabled
  37 - msgmax
  38 - msgmnb
  39 - msgmni
  40 - nmi_watchdog
  41 - osrelease
  42 - ostype
  43 - overflowgid
  44 - overflowuid
  45 - panic
  46 - pid_max
  47 - powersave-nap               [ PPC only ]
  48 - panic_on_unrecovered_nmi
  49 - printk
  50 - randomize_va_space
  51 - real-root-dev               ==> Documentation/initrd.txt
  52 - reboot-cmd                  [ SPARC only ]
  53 - rtsig-max
  54 - rtsig-nr
  55 - sem
  56 - sg-big-buff                 [ generic SCSI device (sg) ]
  57 - shmall
  58 - shmmax                      [ sysv ipc ]
  59 - shmmni
  60 - stop-a                      [ SPARC only ]
  61 - sysrq                       ==> Documentation/sysrq.txt
  62 - tainted
  63 - threads-max
  64 - unknown_nmi_panic
  65 - version
  66
  67 ==============================================================
  68
  69 acpi_video_flags:
  70
  71 flags
  72
  73 See Doc*/kernel/power/video.txt, it allows mode of video boot to be
  74 set during run time.
  75
  76 ==============================================================
  77
  78 acct:
  79
  80 highwater lowwater frequency
  81
  82 If BSD-style process accounting is enabled these values control
  83 its behaviour. If free space on filesystem where the log lives
  84 goes below <lowwater>% accounting suspends. If free space gets
  85 above <highwater>% accounting resumes. <Frequency> determines
  86 how often do we check the amount of free space (value is in
  87 seconds). Default:
  88 4 2 30
  89 That is, suspend accounting if there left <= 2% free; resume it
  90 if we got >=4%; consider information about amount of free space
  91 valid for 30 seconds.
  92
  93 ==============================================================
  94
  95 callhome:
  96
  97 Controls the kernel's callhome behavior in case of a kernel panic.
  98
  99 The s390 hardware allows an operating system to send a notification
 100 to a service organization (callhome) in case of an operating system panic.
 101
 102 When the value in this file is 0 (which is the default behavior)
 103 nothing happens in case of a kernel panic. If this value is set to "1"
 104 the complete kernel oops message is send to the IBM customer service
 105 organization in case the mainframe the Linux operating system is running
 106 on has a service contract with IBM.
 107
 108 ==============================================================
 109
 110 core_pattern:
 111
 112 core_pattern is used to specify a core dumpfile pattern name.
 113 . max length 128 characters; default value is "core"
 114 . core_pattern is used as a pattern template for the output filename;
 115   certain string patterns (beginning with '%') are substituted with
 116   their actual values.
 117 . backward compatibility with core_uses_pid:
 118         If core_pattern does not include "%p" (default does not)
 119         and core_uses_pid is set, then .PID will be appended to
 120         the filename.
 121 . corename format specifiers:
 122         %<NUL>  '%' is dropped
 123         %%      output one '%'
 124         %p      pid
 125         %u      uid
 126         %g      gid
 127         %s      signal number
 128         %t      UNIX time of dump
 129         %h      hostname
 130         %e      executable filename
 131         %<OTHER> both are dropped
 132 . If the first character of the pattern is a '|', the kernel will treat
 133   the rest of the pattern as a command to run.  The core dump will be
 134   written to the standard input of that program instead of to a file.
 135
 136 ==============================================================
 137
 138 core_uses_pid:
 139
 140 The default coredump filename is "core".  By setting
 141 core_uses_pid to 1, the coredump filename becomes core.PID.
 142 If core_pattern does not include "%p" (default does not)
 143 and core_uses_pid is set, then .PID will be appended to
 144 the filename.
 145
 146 ==============================================================
 147
 148 ctrl-alt-del:
 149
 150 When the value in this file is 0, ctrl-alt-del is trapped and
 151 sent to the init(1) program to handle a graceful restart.
 152 When, however, the value is > 0, Linux's reaction to a Vulcan
 153 Nerve Pinch (tm) will be an immediate reboot, without even
 154 syncing its dirty buffers.
 155
 156 Note: when a program (like dosemu) has the keyboard in 'raw'
 157 mode, the ctrl-alt-del is intercepted by the program before it
 158 ever reaches the kernel tty layer, and it's up to the program
 159 to decide what to do with it.
 160
 161 ==============================================================
 162
 163 domainname & hostname:
 164
 165 These files can be used to set the NIS/YP domainname and the
 166 hostname of your box in exactly the same way as the commands
 167 domainname and hostname, i.e.:
 168 # echo "darkstar" > /proc/sys/kernel/hostname
 169 # echo "mydomain" > /proc/sys/kernel/domainname
 170 has the same effect as
 171 # hostname "darkstar"
 172 # domainname "mydomain"
 173
 174 Note, however, that the classic darkstar.frop.org has the
 175 hostname "darkstar" and DNS (Internet Domain Name Server)
 176 domainname "frop.org", not to be confused with the NIS (Network
 177 Information Service) or YP (Yellow Pages) domainname. These two
 178 domain names are in general different. For a detailed discussion
 179 see the hostname(1) man page.
 180
 181 ==============================================================
 182
 183 hotplug:
 184
 185 Path for the hotplug policy agent.
 186 Default value is "/sbin/hotplug".
 187
 188 ==============================================================
 189
 190 l2cr: (PPC only)
 191
 192 This flag controls the L2 cache of G3 processor boards. If
 193 0, the cache is disabled. Enabled if nonzero.
 194
 195 ==============================================================
 196
 197 kstack_depth_to_print: (X86 only)
 198
 199 Controls the number of words to print when dumping the raw
 200 kernel stack.
 201
 202 ==============================================================
 203
 204 modules_disabled:
 205
 206 A toggle value indicating if modules are allowed to be loaded
 207 in an otherwise modular kernel.  This toggle defaults to off
 208 (0), but can be set true (1).  Once true, modules can be
 209 neither loaded nor unloaded, and the toggle cannot be set back
 210 to false.
 211
 212 ==============================================================
 213
 214 osrelease, ostype & version:
 215
 216 # cat osrelease
 217 2.1.88
 218 # cat ostype
 219 Linux
 220 # cat version
 221 #5 Wed Feb 25 21:49:24 MET 1998
 222
 223 The files osrelease and ostype should be clear enough. Version
 224 needs a little more clarification however. The '#5' means that
 225 this is the fifth kernel built from this source base and the
 226 date behind it indicates the time the kernel was built.
 227 The only way to tune these values is to rebuild the kernel :-)
 228
 229 ==============================================================
 230
 231 overflowgid & overflowuid:
 232
 233 if your architecture did not always support 32-bit UIDs (i.e. arm, i386,
 234 m68k, sh, and sparc32), a fixed UID and GID will be returned to
 235 applications that use the old 16-bit UID/GID system calls, if the actual
 236 UID or GID would exceed 65535.
 237
 238 These sysctls allow you to change the value of the fixed UID and GID.
 239 The default is 65534.
 240
 241 ==============================================================
 242
 243 panic:
 244
 245 The value in this file represents the number of seconds the
 246 kernel waits before rebooting on a panic. When you use the
 247 software watchdog, the recommended setting is 60.
 248
 249 ==============================================================
 250
 251 panic_on_oops:
 252
 253 Controls the kernel's behaviour when an oops or BUG is encountered.
 254
 255 0: try to continue operation
 256
 257 1: panic immediately.  If the `panic' sysctl is also non-zero then the
 258    machine will be rebooted.
 259
 260 ==============================================================
 261
 262 pid_max:
 263
 264 PID allocation wrap value.  When the kernel's next PID value
 265 reaches this value, it wraps back to a minimum PID value.
 266 PIDs of value pid_max or larger are not allocated.
 267
 268 ==============================================================
 269
 270 powersave-nap: (PPC only)
 271
 272 If set, Linux-PPC will use the 'nap' mode of powersaving,
 273 otherwise the 'doze' mode will be used.
 274
 275 ==============================================================
 276
 277 printk:
 278
 279 The four values in printk denote: console_loglevel,
 280 default_message_loglevel, minimum_console_loglevel and
 281 default_console_loglevel respectively.
 282
 283 These values influence printk() behavior when printing or
 284 logging error messages. See 'man 2 syslog' for more info on
 285 the different loglevels.
 286
 287 - console_loglevel: messages with a higher priority than
 288   this will be printed to the console
 289 - default_message_level: messages without an explicit priority
 290   will be printed with this priority
 291 - minimum_console_loglevel: minimum (highest) value to which
 292   console_loglevel can be set
 293 - default_console_loglevel: default value for console_loglevel
 294
 295 ==============================================================
 296
 297 printk_ratelimit:
 298
 299 Some warning messages are rate limited. printk_ratelimit specifies
 300 the minimum length of time between these messages (in jiffies), by
 301 default we allow one every 5 seconds.
 302
 303 A value of 0 will disable rate limiting.
 304
 305 ==============================================================
 306
 307 printk_ratelimit_burst:
 308
 309 While long term we enforce one message per printk_ratelimit
 310 seconds, we do allow a burst of messages to pass through.
 311 printk_ratelimit_burst specifies the number of messages we can
 312 send before ratelimiting kicks in.
 313
 314 ==============================================================
 315
 316 printk_delay:
 317
 318 Delay each printk message in printk_delay milliseconds
 319
 320 Value from 0 - 10000 is allowed.
 321
 322 ==============================================================
 323
 324 randomize-va-space:
 325
 326 This option can be used to select the type of process address
 327 space randomization that is used in the system, for architectures
 328 that support this feature.
 329
 330 0 - Turn the process address space randomization off.  This is the
 331     default for architectures that do not support this feature anyways,
 332     and kernels that are booted with the "norandmaps" parameter.
 333
 334 1 - Make the addresses of mmap base, stack and VDSO page randomized.
 335     This, among other things, implies that shared libraries will be
 336     loaded to random addresses.  Also for PIE-linked binaries, the
 337     location of code start is randomized.  This is the default if the
 338     CONFIG_COMPAT_BRK option is enabled.
 339
 340 2 - Additionally enable heap randomization.  This is the default if
 341     CONFIG_COMPAT_BRK is disabled.
 342
 343     There are a few legacy applications out there (such as some ancient
 344     versions of libc.so.5 from 1996) that assume that brk area starts
 345     just after the end of the code+bss.  These applications break when
 346     start of the brk area is randomized.  There are however no known
 347     non-legacy applications that would be broken this way, so for most
 348     systems it is safe to choose full randomization.
 349
 350     Systems with ancient and/or broken binaries should be configured
 351     with CONFIG_COMPAT_BRK enabled, which excludes the heap from process
 352     address space randomization.
 353
 354 ==============================================================
 355
 356 reboot-cmd: (Sparc only)
 357
 358 ??? This seems to be a way to give an argument to the Sparc
 359 ROM/Flash boot loader. Maybe to tell it what to do after
 360 rebooting. ???
 361
 362 ==============================================================
 363
 364 rtsig-max & rtsig-nr:
 365
 366 The file rtsig-max can be used to tune the maximum number
 367 of POSIX realtime (queued) signals that can be outstanding
 368 in the system.
 369
 370 rtsig-nr shows the number of RT signals currently queued.
 371
 372 ==============================================================
 373
 374 sg-big-buff:
 375
 376 This file shows the size of the generic SCSI (sg) buffer.
 377 You can't tune it just yet, but you could change it on
 378 compile time by editing include/scsi/sg.h and changing
 379 the value of SG_BIG_BUFF.
 380
 381 There shouldn't be any reason to change this value. If
 382 you can come up with one, you probably know what you
 383 are doing anyway :)
 384
 385 ==============================================================
 386
 387 shmmax:
 388
 389 This value can be used to query and set the run time limit
 390 on the maximum shared memory segment size that can be created.
 391 Shared memory segments up to 1Gb are now supported in the
 392 kernel.  This value defaults to SHMMAX.
 393
 394 ==============================================================
 395
 396 softlockup_thresh:
 397
 398 This value can be used to lower the softlockup tolerance threshold.  The
 399 default threshold is 60 seconds.  If a cpu is locked up for 60 seconds,
 400 the kernel complains.  Valid values are 1-60 seconds.  Setting this
 401 tunable to zero will disable the softlockup detection altogether.
 402
 403 ==============================================================
 404
 405 tainted:
 406
 407 Non-zero if the kernel has been tainted.  Numeric values, which
 408 can be ORed together:
 409
 410    1 - A module with a non-GPL license has been loaded, this
 411        includes modules with no license.
 412        Set by modutils >= 2.4.9 and module-init-tools.
 413    2 - A module was force loaded by insmod -f.
 414        Set by modutils >= 2.4.9 and module-init-tools.
 415    4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
 416    8 - A module was forcibly unloaded from the system by rmmod -f.
 417   16 - A hardware machine check error occurred on the system.
 418   32 - A bad page was discovered on the system.
 419   64 - The user has asked that the system be marked "tainted".  This
 420        could be because they are running software that directly modifies
 421        the hardware, or for other reasons.
 422  128 - The system has died.
 423  256 - The ACPI DSDT has been overridden with one supplied by the user
 424         instead of using the one provided by the hardware.
 425  512 - A kernel warning has occurred.
 426 1024 - A module from drivers/staging was loaded.
 427
 428 ==============================================================
 429
 430 auto_msgmni:
 431
 432 Enables/Disables automatic recomputing of msgmni upon memory add/remove or
 433 upon ipc namespace creation/removal (see the msgmni description above).
 434 Echoing "1" into this file enables msgmni automatic recomputing.
 435 Echoing "0" turns it off.
 436 auto_msgmni default value is 1.
 437
 438 ==============================================================
 439
 440 nmi_watchdog:
 441
 442 Enables/Disables the NMI watchdog on x86 systems.  When the value is non-zero
 443 the NMI watchdog is enabled and will continuously test all online cpus to
 444 determine whether or not they are still functioning properly. Currently,
 445 passing "nmi_watchdog=" parameter at boot time is required for this function
 446 to work.
 447
 448 If LAPIC NMI watchdog method is in use (nmi_watchdog=2 kernel parameter), the
 449 NMI watchdog shares registers with oprofile. By disabling the NMI watchdog,
 450 oprofile may have more registers to utilize.
 451
 452 ==============================================================
 453
 454 unknown_nmi_panic:
 455
 456 The value in this file affects behavior of handling NMI. When the value is
 457 non-zero, unknown NMI is trapped and then panic occurs. At that time, kernel
 458 debugging information is displayed on console.
 459
 460 NMI switch that most IA32 servers have fires unknown NMI up, for example.
 461 If a system hangs up, try pressing the NMI switch.
 462
 463 ==============================================================
 464
 465 panic_on_unrecovered_nmi:
 466
 467 The default Linux behaviour on an NMI of either memory or unknown is to continue
 468 operation. For many environments such as scientific computing it is preferable
 469 that the box is taken out and the error dealt with than an uncorrected
 470 parity/ECC error get propogated.
 471
 472 A small number of systems do generate NMI's for bizarre random reasons such as
 473 power management so the default is off. That sysctl works like the existing
 474 panic controls already in that directory.
 475