Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | Documentation for /proc/sys/kernel/* kernel version 2.2.10 |
| 2 | (c) 1998, 1999, Rik van Riel <riel@nl.linux.org> |
| 3 | |
| 4 | For general info and legal blurb, please look in README. |
| 5 | |
| 6 | ============================================================== |
| 7 | |
| 8 | This file contains documentation for the sysctl files in |
| 9 | /proc/sys/kernel/ and is valid for Linux kernel version 2.2. |
| 10 | |
| 11 | The files in this directory can be used to tune and monitor |
| 12 | miscellaneous and general things in the operation of the Linux |
| 13 | kernel. Since some of the files _can_ be used to screw up your |
| 14 | system, it is advisable to read both documentation and source |
| 15 | before actually making adjustments. |
| 16 | |
| 17 | Currently, these files might (depending on your configuration) |
| 18 | show up in /proc/sys/kernel: |
Pavel Machek | c255d84 | 2006-02-20 18:27:58 -0800 | [diff] [blame] | 19 | - acpi_video_flags |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 20 | - acct |
| 21 | - core_pattern |
| 22 | - core_uses_pid |
| 23 | - ctrl-alt-del |
| 24 | - dentry-state |
| 25 | - domainname |
| 26 | - hostname |
| 27 | - hotplug |
| 28 | - java-appletviewer [ binfmt_java, obsolete ] |
| 29 | - java-interpreter [ binfmt_java, obsolete ] |
Chuck Ebbert | 0741f4d | 2006-12-07 02:14:11 +0100 | [diff] [blame] | 30 | - kstack_depth_to_print [ X86 only ] |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 31 | - l2cr [ PPC only ] |
| 32 | - modprobe ==> Documentation/kmod.txt |
| 33 | - msgmax |
| 34 | - msgmnb |
| 35 | - msgmni |
| 36 | - osrelease |
| 37 | - ostype |
| 38 | - overflowgid |
| 39 | - overflowuid |
| 40 | - panic |
| 41 | - pid_max |
| 42 | - powersave-nap [ PPC only ] |
| 43 | - printk |
| 44 | - real-root-dev ==> Documentation/initrd.txt |
| 45 | - reboot-cmd [ SPARC only ] |
| 46 | - rtsig-max |
| 47 | - rtsig-nr |
| 48 | - sem |
| 49 | - sg-big-buff [ generic SCSI device (sg) ] |
| 50 | - shmall |
| 51 | - shmmax [ sysv ipc ] |
| 52 | - shmmni |
| 53 | - stop-a [ SPARC only ] |
| 54 | - sysrq ==> Documentation/sysrq.txt |
| 55 | - tainted |
| 56 | - threads-max |
| 57 | - version |
| 58 | |
| 59 | ============================================================== |
| 60 | |
Pavel Machek | c255d84 | 2006-02-20 18:27:58 -0800 | [diff] [blame] | 61 | acpi_video_flags: |
| 62 | |
| 63 | flags |
| 64 | |
| 65 | See Doc*/kernel/power/video.txt, it allows mode of video boot to be |
| 66 | set during run time. |
| 67 | |
| 68 | ============================================================== |
| 69 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 70 | acct: |
| 71 | |
| 72 | highwater lowwater frequency |
| 73 | |
| 74 | If BSD-style process accounting is enabled these values control |
| 75 | its behaviour. If free space on filesystem where the log lives |
| 76 | goes below <lowwater>% accounting suspends. If free space gets |
| 77 | above <highwater>% accounting resumes. <Frequency> determines |
| 78 | how often do we check the amount of free space (value is in |
| 79 | seconds). Default: |
| 80 | 4 2 30 |
| 81 | That is, suspend accounting if there left <= 2% free; resume it |
| 82 | if we got >=4%; consider information about amount of free space |
| 83 | valid for 30 seconds. |
| 84 | |
| 85 | ============================================================== |
| 86 | |
| 87 | core_pattern: |
| 88 | |
| 89 | core_pattern is used to specify a core dumpfile pattern name. |
Matthias Urlichs | cd08104 | 2006-10-11 01:21:57 -0700 | [diff] [blame] | 90 | . max length 128 characters; default value is "core" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 91 | . core_pattern is used as a pattern template for the output filename; |
| 92 | certain string patterns (beginning with '%') are substituted with |
| 93 | their actual values. |
| 94 | . backward compatibility with core_uses_pid: |
| 95 | If core_pattern does not include "%p" (default does not) |
| 96 | and core_uses_pid is set, then .PID will be appended to |
| 97 | the filename. |
| 98 | . corename format specifiers: |
| 99 | %<NUL> '%' is dropped |
| 100 | %% output one '%' |
| 101 | %p pid |
| 102 | %u uid |
| 103 | %g gid |
| 104 | %s signal number |
| 105 | %t UNIX time of dump |
| 106 | %h hostname |
| 107 | %e executable filename |
| 108 | %<OTHER> both are dropped |
Matthias Urlichs | cd08104 | 2006-10-11 01:21:57 -0700 | [diff] [blame] | 109 | . If the first character of the pattern is a '|', the kernel will treat |
| 110 | the rest of the pattern as a command to run. The core dump will be |
| 111 | written to the standard input of that program instead of to a file. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | |
| 113 | ============================================================== |
| 114 | |
| 115 | core_uses_pid: |
| 116 | |
| 117 | The default coredump filename is "core". By setting |
| 118 | core_uses_pid to 1, the coredump filename becomes core.PID. |
| 119 | If core_pattern does not include "%p" (default does not) |
| 120 | and core_uses_pid is set, then .PID will be appended to |
| 121 | the filename. |
| 122 | |
| 123 | ============================================================== |
| 124 | |
| 125 | ctrl-alt-del: |
| 126 | |
| 127 | When the value in this file is 0, ctrl-alt-del is trapped and |
| 128 | sent to the init(1) program to handle a graceful restart. |
| 129 | When, however, the value is > 0, Linux's reaction to a Vulcan |
| 130 | Nerve Pinch (tm) will be an immediate reboot, without even |
| 131 | syncing its dirty buffers. |
| 132 | |
| 133 | Note: when a program (like dosemu) has the keyboard in 'raw' |
| 134 | mode, the ctrl-alt-del is intercepted by the program before it |
| 135 | ever reaches the kernel tty layer, and it's up to the program |
| 136 | to decide what to do with it. |
| 137 | |
| 138 | ============================================================== |
| 139 | |
| 140 | domainname & hostname: |
| 141 | |
| 142 | These files can be used to set the NIS/YP domainname and the |
| 143 | hostname of your box in exactly the same way as the commands |
| 144 | domainname and hostname, i.e.: |
| 145 | # echo "darkstar" > /proc/sys/kernel/hostname |
| 146 | # echo "mydomain" > /proc/sys/kernel/domainname |
| 147 | has the same effect as |
| 148 | # hostname "darkstar" |
| 149 | # domainname "mydomain" |
| 150 | |
| 151 | Note, however, that the classic darkstar.frop.org has the |
| 152 | hostname "darkstar" and DNS (Internet Domain Name Server) |
| 153 | domainname "frop.org", not to be confused with the NIS (Network |
| 154 | Information Service) or YP (Yellow Pages) domainname. These two |
| 155 | domain names are in general different. For a detailed discussion |
| 156 | see the hostname(1) man page. |
| 157 | |
| 158 | ============================================================== |
| 159 | |
| 160 | hotplug: |
| 161 | |
| 162 | Path for the hotplug policy agent. |
| 163 | Default value is "/sbin/hotplug". |
| 164 | |
| 165 | ============================================================== |
| 166 | |
| 167 | l2cr: (PPC only) |
| 168 | |
| 169 | This flag controls the L2 cache of G3 processor boards. If |
| 170 | 0, the cache is disabled. Enabled if nonzero. |
| 171 | |
| 172 | ============================================================== |
| 173 | |
Chuck Ebbert | 0741f4d | 2006-12-07 02:14:11 +0100 | [diff] [blame] | 174 | kstack_depth_to_print: (X86 only) |
| 175 | |
| 176 | Controls the number of words to print when dumping the raw |
| 177 | kernel stack. |
| 178 | |
| 179 | ============================================================== |
| 180 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 181 | osrelease, ostype & version: |
| 182 | |
| 183 | # cat osrelease |
| 184 | 2.1.88 |
| 185 | # cat ostype |
| 186 | Linux |
| 187 | # cat version |
| 188 | #5 Wed Feb 25 21:49:24 MET 1998 |
| 189 | |
| 190 | The files osrelease and ostype should be clear enough. Version |
| 191 | needs a little more clarification however. The '#5' means that |
| 192 | this is the fifth kernel built from this source base and the |
| 193 | date behind it indicates the time the kernel was built. |
| 194 | The only way to tune these values is to rebuild the kernel :-) |
| 195 | |
| 196 | ============================================================== |
| 197 | |
| 198 | overflowgid & overflowuid: |
| 199 | |
| 200 | if your architecture did not always support 32-bit UIDs (i.e. arm, i386, |
| 201 | m68k, sh, and sparc32), a fixed UID and GID will be returned to |
| 202 | applications that use the old 16-bit UID/GID system calls, if the actual |
| 203 | UID or GID would exceed 65535. |
| 204 | |
| 205 | These sysctls allow you to change the value of the fixed UID and GID. |
| 206 | The default is 65534. |
| 207 | |
| 208 | ============================================================== |
| 209 | |
| 210 | panic: |
| 211 | |
| 212 | The value in this file represents the number of seconds the |
| 213 | kernel waits before rebooting on a panic. When you use the |
| 214 | software watchdog, the recommended setting is 60. |
| 215 | |
| 216 | ============================================================== |
| 217 | |
| 218 | panic_on_oops: |
| 219 | |
| 220 | Controls the kernel's behaviour when an oops or BUG is encountered. |
| 221 | |
| 222 | 0: try to continue operation |
| 223 | |
Matt LaPlante | a982ac0 | 2007-05-09 07:35:06 +0200 | [diff] [blame] | 224 | 1: panic immediately. If the `panic' sysctl is also non-zero then the |
Maxime Bizon | 8b23d04d | 2006-08-05 12:14:32 -0700 | [diff] [blame] | 225 | machine will be rebooted. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 226 | |
| 227 | ============================================================== |
| 228 | |
| 229 | pid_max: |
| 230 | |
Robert P. J. Day | beb7dd8 | 2007-05-09 07:14:03 +0200 | [diff] [blame] | 231 | PID allocation wrap value. When the kernel's next PID value |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 232 | reaches this value, it wraps back to a minimum PID value. |
| 233 | PIDs of value pid_max or larger are not allocated. |
| 234 | |
| 235 | ============================================================== |
| 236 | |
| 237 | powersave-nap: (PPC only) |
| 238 | |
| 239 | If set, Linux-PPC will use the 'nap' mode of powersaving, |
| 240 | otherwise the 'doze' mode will be used. |
| 241 | |
| 242 | ============================================================== |
| 243 | |
| 244 | printk: |
| 245 | |
| 246 | The four values in printk denote: console_loglevel, |
| 247 | default_message_loglevel, minimum_console_loglevel and |
| 248 | default_console_loglevel respectively. |
| 249 | |
| 250 | These values influence printk() behavior when printing or |
| 251 | logging error messages. See 'man 2 syslog' for more info on |
| 252 | the different loglevels. |
| 253 | |
| 254 | - console_loglevel: messages with a higher priority than |
| 255 | this will be printed to the console |
| 256 | - default_message_level: messages without an explicit priority |
| 257 | will be printed with this priority |
| 258 | - minimum_console_loglevel: minimum (highest) value to which |
| 259 | console_loglevel can be set |
| 260 | - default_console_loglevel: default value for console_loglevel |
| 261 | |
| 262 | ============================================================== |
| 263 | |
| 264 | printk_ratelimit: |
| 265 | |
| 266 | Some warning messages are rate limited. printk_ratelimit specifies |
| 267 | the minimum length of time between these messages (in jiffies), by |
| 268 | default we allow one every 5 seconds. |
| 269 | |
| 270 | A value of 0 will disable rate limiting. |
| 271 | |
| 272 | ============================================================== |
| 273 | |
| 274 | printk_ratelimit_burst: |
| 275 | |
| 276 | While long term we enforce one message per printk_ratelimit |
| 277 | seconds, we do allow a burst of messages to pass through. |
| 278 | printk_ratelimit_burst specifies the number of messages we can |
| 279 | send before ratelimiting kicks in. |
| 280 | |
| 281 | ============================================================== |
| 282 | |
| 283 | reboot-cmd: (Sparc only) |
| 284 | |
| 285 | ??? This seems to be a way to give an argument to the Sparc |
| 286 | ROM/Flash boot loader. Maybe to tell it what to do after |
| 287 | rebooting. ??? |
| 288 | |
| 289 | ============================================================== |
| 290 | |
| 291 | rtsig-max & rtsig-nr: |
| 292 | |
| 293 | The file rtsig-max can be used to tune the maximum number |
| 294 | of POSIX realtime (queued) signals that can be outstanding |
| 295 | in the system. |
| 296 | |
| 297 | rtsig-nr shows the number of RT signals currently queued. |
| 298 | |
| 299 | ============================================================== |
| 300 | |
| 301 | sg-big-buff: |
| 302 | |
| 303 | This file shows the size of the generic SCSI (sg) buffer. |
| 304 | You can't tune it just yet, but you could change it on |
| 305 | compile time by editing include/scsi/sg.h and changing |
| 306 | the value of SG_BIG_BUFF. |
| 307 | |
| 308 | There shouldn't be any reason to change this value. If |
| 309 | you can come up with one, you probably know what you |
| 310 | are doing anyway :) |
| 311 | |
| 312 | ============================================================== |
| 313 | |
| 314 | shmmax: |
| 315 | |
| 316 | This value can be used to query and set the run time limit |
| 317 | on the maximum shared memory segment size that can be created. |
| 318 | Shared memory segments up to 1Gb are now supported in the |
| 319 | kernel. This value defaults to SHMMAX. |
| 320 | |
| 321 | ============================================================== |
| 322 | |
Ravikiran G Thirumalai | c4f3b63 | 2007-10-16 23:26:09 -0700 | [diff] [blame^] | 323 | softlockup_thresh: |
| 324 | |
| 325 | This value can be used to lower the softlockup tolerance |
| 326 | threshold. The default threshold is 10s. If a cpu is locked up |
| 327 | for 10s, the kernel complains. Valid values are 1-60s. |
| 328 | |
| 329 | ============================================================== |
| 330 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 331 | tainted: |
| 332 | |
| 333 | Non-zero if the kernel has been tainted. Numeric values, which |
| 334 | can be ORed together: |
| 335 | |
| 336 | 1 - A module with a non-GPL license has been loaded, this |
| 337 | includes modules with no license. |
| 338 | Set by modutils >= 2.4.9 and module-init-tools. |
| 339 | 2 - A module was force loaded by insmod -f. |
| 340 | Set by modutils >= 2.4.9 and module-init-tools. |
| 341 | 4 - Unsafe SMP processors: SMP with CPUs not designed for SMP. |
| 342 | |