| .\" Copyright 1999, George Staikos (staikos@0wned.org) |
| .\" This file may be used subject to the terms and conditions of the |
| .\" GNU General Public License Version 2, or any later version |
| .\" at your option, as published by the Free Software Foundation. |
| .\" This program is distributed in the hope that it will be useful, |
| .\" but WITHOUT ANY WARRANTY; without even the implied warranty of |
| .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| .\" GNU General Public License for more details." |
| .TH SYSCTL 8 "21 Sep 1999" "" "" |
| .SH NAME |
| sysctl \- configure kernel parameters at runtime |
| .SH SYNOPSIS |
| .B "sysctl [-n] [-e] variable ..." |
| .br |
| .B "sysctl [-n] [-e] [-q] -w variable=value ..." |
| .br |
| .B "sysctl [-n] [-e] [-q] -p <filename>" |
| .br |
| .B "sysctl [-n] [-e] -a" |
| .br |
| .B "sysctl [-n] [-e] -A" |
| .SH DESCRIPTION |
| .B sysctl |
| is used to modify kernel parameters at runtime. The parameters available |
| are those listed under /proc/sys/. Procfs is required for |
| .B sysctl(8) |
| support in Linux. You can use |
| .B sysctl(8) |
| to both read and write sysctl data. |
| .SH PARAMETERS |
| .TP |
| .B "variable" |
| The name of a key to read from. An example is kernel.ostype. The '/' |
| separator is also accepted in place of a '.'. |
| .TP |
| .B "variable=value" |
| To set a key, use the form variable=value, where variable is the key and |
| value is the value to set it to. If the value contains quotes or characters |
| which are parsed by the shell, you may need to enclose the value in double |
| quotes. This requires the -w parameter to use. |
| .TP |
| .B "-n" |
| Use this option to disable printing of the key name when printing values. |
| .TP |
| .B "-e" |
| Use this option to ignore errors about unknown keys. |
| .TP |
| .B "-N" |
| Use this option to only print the names. It may be useful with shells that |
| have programmable completion. |
| .TP |
| .B "-q" |
| Use this option to not display the values set to stdout. |
| .TP |
| .B "-w" |
| Use this option when you want to change a sysctl setting. |
| .TP |
| .B "-p" |
| Load in sysctl settings from the file specified or /etc/sysctl.conf if none given. |
| Specifying \- as filename means reading data from standard input. |
| .TP |
| .B "-a" |
| Display all values currently available. |
| .TP |
| .B "-A" |
| Display all values currently available in table form. |
| .SH EXAMPLES |
| .TP |
| /sbin/sysctl -a |
| .TP |
| /sbin/sysctl -n kernel.hostname |
| .TP |
| /sbin/sysctl -w kernel.domainname="example.com" |
| .TP |
| /sbin/sysctl -p /etc/sysctl.conf |
| .SH FILES |
| .I /proc/sys |
| .I /etc/sysctl.conf |
| .SH SEE ALSO |
| .BR sysctl.conf (5) |
| .SH BUGS |
| The -A parameter behaves just as -a does. |
| .SH AUTHOR |
| George Staikos, <staikos@0wned.org> |
| |