procps/sysctl.conf.5
Craig Small a6c0795d49 sysctl: ignore errors from lines starting with -
The systemd sysctl ignores errors from preload files that start
with a hyphen.  This change brings the procps sysctl into line with
their change.

References:
    procps-ng/procps#138
    https://github.com/systemd/systemd/pull/13191
    https://github.com/systemd/systemd/pull/13141
2019-09-21 15:53:45 +10:00

86 lines
2.0 KiB
Groff

.\" 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.CONF "5" "2019-09-21" "procps-ng" "File Formats"
.SH NAME
sysctl.conf \- sysctl preload/configuration file
.SH DESCRIPTION
.B sysctl.conf
is a simple file containing sysctl values to be read in and set by
.BR sysctl .
The syntax is simply as follows:
.RS
.sp
.nf
.ne 7
# comment
; comment
token = value
.fi
.RE
.PP
Note that blank lines are ignored, and whitespace before and after a token or
value is ignored, although a value can contain whitespace within. Lines which
begin with a # or ; are considered comments and ignored.
If a line begins with a single \-, any attempts to set the value that fail will be
ignored.
.SH NOTES
As the
.BR /etc/sysctl.conf
file is used to override default kernel parameter values, only a small number of parameters is predefined in the file.
Use
.IR /sbin/sysctl\ \-a
or follow
.BR sysctl (8)
to list all possible parameters. The description of individual parameters can be found in the kernel documentation.
.SH EXAMPLE
.RS
.sp
.nf
.ne 7
# sysctl.conf sample
#
kernel.domainname = example.com
; this one has a space which will be written to the sysctl!
kernel.modprobe = /sbin/mod probe
.fi
.RE
.PP
.SH FILES
.TP
/run/sysctl.d/*.conf
.TQ
/etc/sysctl.d/*.conf
.TQ
/usr/local/lib/sysctl.d/*.conf
.TQ
/usr/lib/sysctl.d/*.conf
.TQ
/lib/sysctl.d/*.conf
.TQ
/etc/sysctl.conf
The paths where
sysctl
preload files usually exist. See also
sysctl
option
.IR \-\-system .
.SH SEE ALSO
.BR sysctl (8)
.SH AUTHOR
.UR staikos@0wned.org
George Staikos
.UE
.SH "REPORTING BUGS"
Please send bug reports to
.UR procps@freelists.org
.UE