manual/procps/original/man8/sysctl.8

   1 .\" Copyright 1999, George Staikos (staikos@0wned.org)
   2 .\" This file may be used subject to the terms and conditions of the
   3 .\" GNU General Public License Version 2, or any later version
   4 .\" at your option, as published by the Free Software Foundation.
   5 .\" This program is distributed in the hope that it will be useful,
   6 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
   7 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
   8 .\" GNU General Public License for more details."
   9 .TH SYSCTL 8 "21 Sep 1999" "" ""
  10 .SH NAME
  11 sysctl \- configure kernel parameters at runtime
  12 .SH SYNOPSIS
  13 .B "sysctl [-n] [-e] variable ..."
  14 .br
  15 .B "sysctl [-n] [-e] [-q] -w variable=value ..."
  16 .br
  17 .B "sysctl [-n] [-e] [-q] -p <filename>"
  18 .br
  19 .B "sysctl [-n] [-e] -a"
  20 .br
  21 .B "sysctl [-n] [-e] -A"
  22 .SH DESCRIPTION
  23 .B sysctl
  24 is used to modify kernel parameters at runtime.  The parameters available
  25 are those listed under /proc/sys/.  Procfs is required for
  26 .B sysctl(8)
  27 support in Linux.  You can use
  28 .B sysctl(8)
  29 to both read and write sysctl data.
  30 .SH PARAMETERS
  31 .TP
  32 .B "variable"
  33 The name of a key to read from.  An example is kernel.ostype.  The '/'
  34 separator is also accepted in place of a '.'.
  35 .TP
  36 .B "variable=value"
  37 To set a key, use the form variable=value, where variable is the key and
  38 value is the value to set it to.  If the value contains quotes or characters
  39 which are parsed by the shell, you may need to enclose the value in double
  40 quotes.  This requires the -w parameter to use.
  41 .TP
  42 .B "-n"
  43 Use this option to disable printing of the key name when printing values.
  44 .TP
  45 .B "-e"
  46 Use this option to ignore errors about unknown keys.
  47 .TP
  48 .B "-N"
  49 Use this option to only print the names. It may be useful with shells that
  50 have programmable completion.
  51 .TP
  52 .B "-q"
  53 Use this option to not display the values set to stdout.
  54 .TP
  55 .B "-w"
  56 Use this option when you want to change a sysctl setting.
  57 .TP
  58 .B "-p"
  59 Load in sysctl settings from the file specified or /etc/sysctl.conf if none given.
  60 .TP
  61 .B "-a"
  62 Display all values currently available.
  63 .TP
  64 .B "-A"
  65 Display all values currently available in table form.
  66 .SH EXAMPLES
  67 .TP
  68 /sbin/sysctl -a
  69 .TP
  70 /sbin/sysctl -n kernel.hostname
  71 .TP
  72 /sbin/sysctl -w kernel.domainname="example.com"
  73 .TP
  74 /sbin/sysctl -p /etc/sysctl.conf
  75 .SH FILES
  76 .I /proc/sys
  77 .I /etc/sysctl.conf
  78 .SH SEE ALSO
  79 .BR sysctl.conf (5)
  80 .SH BUGS
  81 The -A parameter behaves just as -a does.
  82 .SH AUTHOR
  83 George Staikos, <staikos@0wned.org>
  84