148 lines
3.2 KiB
Diff
148 lines
3.2 KiB
Diff
Author: <csmall@debian.org>
|
|
Description: -p flag has OPTIONAL filename
|
|
cleanup sysctl man page
|
|
Bug-Debian: http://bugs.debian.org/297144
|
|
Bug-Debian: http://bugs.debian.org/282168
|
|
Index: b/sysctl.8
|
|
===================================================================
|
|
--- a/sysctl.8 2009-11-24 20:53:05.000000000 +1100
|
|
+++ b/sysctl.8 2009-11-24 21:00:32.000000000 +1100
|
|
@@ -10,76 +10,108 @@
|
|
.SH NAME
|
|
sysctl \- configure kernel parameters at runtime
|
|
.SH SYNOPSIS
|
|
-.B "sysctl [-n] [-e] variable ..."
|
|
+.B sysctl
|
|
+.RB [ \-n ]
|
|
+.RB [ \-e ]
|
|
+.I variable
|
|
+\&...
|
|
.br
|
|
-.B "sysctl [-n] [-e] [-q] -w variable=value ..."
|
|
+.B sysctl
|
|
+.RB [ \-n ]
|
|
+.RB [ \-e ]
|
|
+.RB [ \-q ]
|
|
+.B \-w
|
|
+.IR variable = value
|
|
+\&...
|
|
.br
|
|
-.B "sysctl [-n] [-e] [-q] -p <filename>"
|
|
+.B sysctl
|
|
+.RB [ \-n ]
|
|
+.RB [ \-e ]
|
|
+.RB [ \-q ]
|
|
+.B \-p
|
|
+.RI [ filename ]
|
|
.br
|
|
-.B "sysctl [-n] [-e] -a"
|
|
+.B sysctl
|
|
+.RB [ \-n ]
|
|
+.RB [ \-e ]
|
|
+.B \-a
|
|
.br
|
|
-.B "sysctl [-n] [-e] -A"
|
|
+.B sysctl
|
|
+.RB [ \-n ]
|
|
+.RB [ \-e ]
|
|
+.B \-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)
|
|
+.B sysctl
|
|
support in Linux. You can use
|
|
-.B sysctl(8)
|
|
+.B sysctl
|
|
to both read and write sysctl data.
|
|
.SH PARAMETERS
|
|
.TP
|
|
-.B "variable"
|
|
+.I 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
|
|
+.IR variable = value
|
|
+To set a key, use the form
|
|
+.IR variable = value
|
|
+where
|
|
+.I variable
|
|
+is the key and
|
|
+.I 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.
|
|
+quotes. This requires the
|
|
+.B \-w
|
|
+parameter to use.
|
|
.TP
|
|
-.B "-n"
|
|
+.B \-n
|
|
Use this option to disable printing of the key name when printing values.
|
|
.TP
|
|
-.B "-e"
|
|
+.B \-e
|
|
Use this option to ignore errors about unknown keys.
|
|
.TP
|
|
-.B "-N"
|
|
+.B \-N
|
|
Use this option to only print the names. It may be useful with shells that
|
|
have programmable completion.
|
|
.TP
|
|
-.B "-q"
|
|
+.B \-q
|
|
Use this option to not display the values set to stdout.
|
|
.TP
|
|
-.B "-w"
|
|
+.B \-w
|
|
Use this option when you want to change a sysctl setting.
|
|
.TP
|
|
-.B "-p"
|
|
+.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"
|
|
+.B \-a
|
|
Display all values currently available.
|
|
.TP
|
|
-.B "-A"
|
|
+.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
|
|
+/sbin/sysctl \-a
|
|
+.br
|
|
+/sbin/sysctl \-n kernel.hostname
|
|
+.br
|
|
+/sbin/sysctl \-w kernel.domainname="example.com"
|
|
+.br
|
|
+/sbin/sysctl \-p /etc/sysctl.conf
|
|
.SH FILES
|
|
.I /proc/sys
|
|
+.br
|
|
.I /etc/sysctl.conf
|
|
.SH SEE ALSO
|
|
.BR sysctl.conf (5)
|
|
.SH BUGS
|
|
-The -A parameter behaves just as -a does.
|
|
+The
|
|
+.B \-A
|
|
+parameter behaves just as
|
|
+.B \-a
|
|
+does.
|
|
.SH AUTHOR
|
|
George Staikos, <staikos@0wned.org>
|
|
|