i386/linux/linux-2.3.21/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
   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:
  19 - acct
  20 - ctrl-alt-del
  21 - dentry-state
  22 - domainname
  23 - hostname
  24 - htab-reclaim                [ PPC only ]
  25 - java-appletviewer           [ binfmt_java, obsolete ]
  26 - java-interpreter            [ binfmt_java, obsolete ]
  27 - l2cr                        [ PPC only ]
  28 - modprobe                    ==> Documentation/kmod.txt
  29 - osrelease
  30 - ostype
  31 - panic
  32 - powersave-nap               [ PPC only ]
  33 - printk
  34 - real-root-dev               ==> Documentation/initrd.txt
  35 - reboot-cmd                  [ SPARC only ]
  36 - rtsig-nr
  37 - rtsig-max
  38 - sg-big-buff                 [ generic SCSI device (sg) ]
  39 - shmmax                      [ sysv ipc ]
  40 - version
  41 - zero-paged                  [ PPC only ]
  42
  43 ==============================================================
  44
  45 acct:
  46
  47 highwater lowwater frequency
  48
  49 If BSD-style process accounting is enabled these values control
  50 its behaviour. If free space on filesystem where the log lives
  51 goes below <lowwater>% accounting suspends. If free space gets
  52 above <highwater>% accounting resumes. <Frequency> determines
  53 how often do we check the amount of free space (value is in
  54 seconds). Default:
  55 4 2 30
  56 That is, suspend accounting if there left <= 2% free; resume it
  57 if we got >=4%; consider information about amount of free space
  58 valid for 30 seconds.
  59
  60 ==============================================================
  61
  62 ctrl-alt-del:
  63
  64 When the value in this file is 0, ctrl-alt-del is trapped and
  65 sent to the init(1) program to handle a graceful restart.
  66 When, however, the value is > 0, Linux's reaction to a Vulcan
  67 Nerve Pinch (tm) will be an immediate reboot, without even
  68 syncing its dirty buffers.
  69
  70 Note: when a program (like dosemu) has the keyboard in 'raw'
  71 mode, the ctrl-alt-del is intercepted by the program before it
  72 ever reaches the kernel tty layer, and it's up to the program
  73 to decide what to do with it.
  74
  75 ==============================================================
  76
  77 domainname & hostname:
  78
  79 These files can be used to set the NIS/YP domainname and the
  80 hostname of your box in exactly the same way as the commands
  81 domainname and hostname, i.e.:
  82 # echo "darkstar" > /proc/sys/kernel/hostname
  83 # echo "mydomain" > /proc/sys/kernel/domainname
  84 has the same effect as
  85 # hostname "darkstar" > /proc/sys/kernel/hostname
  86 # domainname "mydomain" > /proc/sys/kernel/domainname
  87
  88 Note, however, that the classic darkstar.frop.org has the
  89 hostname "darkstar" and DNS (Internet Domain Name Server)
  90 domainname "frop.org", not to be confused with the NIS (Network
  91 Information Service) or YP (Yellow Pages) domainname. These two
  92 domain names are in general different. For a detailed discussion
  93 see the hostname(1) man page.
  94
  95 ==============================================================
  96
  97 htab-reclaim: (PPC only)
  98
  99 Setting this to a non-zero value, the PowerPC htab
 100 (see Documentation/powerpc/ppc_htab.txt) is pruned
 101 each time the system hits the idle loop.
 102
 103 ==============================================================
 104
 105 l2cr: (PPC only)
 106
 107 This flag controls the L2 cache of G3 processor boards. If
 108 0, the cache is disabled. Enabled if nonzero.
 109
 110 ==============================================================
 111
 112 osrelease, ostype & version:
 113
 114 # cat osrelease
 115 2.1.88
 116 # cat ostype
 117 Linux
 118 # cat version
 119 #5 Wed Feb 25 21:49:24 MET 1998
 120
 121 The files osrelease and ostype should be clear enough. Version
 122 needs a little more clarification however. The '#5' means that
 123 this is the fifth kernel built from this source base and the
 124 date behind it indicates the time the kernel was built.
 125 The only way to tune these values is to rebuild the kernel :-)
 126
 127 ==============================================================
 128
 129 panic:
 130
 131 The value in this file represents the number of seconds the
 132 kernel waits before rebooting on a panic. When you use the
 133 software watchdog, the recommended setting is 60.
 134
 135 ==============================================================
 136
 137 powersave-nap: (PPC only)
 138
 139 If set, Linux-PPC will use the 'nap' mode of powersaving,
 140 otherwise the 'doze' mode will be used.
 141
 142 ==============================================================
 143
 144 printk:
 145
 146 The four values in printk denote: console_loglevel,
 147 default_message_loglevel, minimum_console_level and
 148 default_console_loglevel respectively.
 149
 150 These values influence printk() behavior when printing or
 151 logging error messages. See 'man 2 syslog' for more info on
 152 the different loglevels.
 153
 154 - console_loglevel: messages with a higher priority than
 155   this will be printed to the console
 156 - default_message_level: messages without an explicit priority
 157   will be printed with this priority
 158 - minimum_console_loglevel: minimum (highest) value to which
 159   console_loglevel can be set
 160 - default_console_loglevel: default value for console_loglevel
 161
 162 Note: a quick look in linux/kernel/printk.c will reveal that
 163 these variables aren't put inside a structure, so their order
 164 in-core isn't formally guaranteed and garbage values _might_
 165 occur when the compiler changes. (???)
 166
 167 ==============================================================
 168
 169 reboot-cmd: (Sparc only)
 170
 171 ??? This seems to be a way to give an argument to the Sparc
 172 ROM/Flash boot loader. Maybe to tell it what to do after
 173 rebooting. ???
 174
 175 ==============================================================
 176
 177 rtsig-max & rtsig-nr:
 178
 179 The file rtsig-max can be used to tune the maximum number
 180 of POSIX realtime (queued) signals that can be outstanding
 181 in the system.
 182
 183 Rtsig-nr shows the number of RT signals currently queued.
 184
 185 ==============================================================
 186
 187 sg-big-buff:
 188
 189 This file shows the size of the generic SCSI (sg) buffer.
 190 You can't tune it just yet, but you could change it on
 191 compile time by editing include/scsi/sg.h and changing
 192 the value of SG_BIG_BUFF.
 193
 194 There shouldn't be any reason to change this value. If
 195 you can come up with one, you probably know what you
 196 are doing anyway :)
 197
 198 ==============================================================
 199
 200 shmmax:
 201
 202 This value can be used to query and set the run time limit
 203 on the maximum shared memory segment size that can be created.
 204 Shared memory segments up to 1Gb are now supported in the
 205 kernel.  This value defaults to SHMMAX.
 206
 207 ==============================================================
 208
 209 zero-paged: (PPC only)
 210
 211 When enabled (non-zero), Linux-PPC will pre-zero pages in
 212 the idle loop, possibly speeding up get_free_pages. Since
 213 this only affects what the idle loop is doing, you should
 214 enable this and see if anything changes.