freebsd-nq/share/man/man5/sysctl.conf.5

.\" Copyright (c) 1999 Chris Costello <chris@FreeBSD.org>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
.Dd December 30, 1999
.Dt SYSCTL.CONF 5
.Os
.Sh NAME
.Nm sysctl.conf
.Nd kernel state defaults
.Sh DESCRIPTION
The
.Pa /etc/sysctl.conf
file is read in when the system goes into multi-user mode to set default
settings for the kernel.  The
.Pa /etc/sysctl.conf
is in the format of the
.Xr sysctl 8
command, i.e.\&
.Bd -literal -offset indent
sysctl_mib=value
.Ed
.Pp
Comments are denoted by a
.Dq #
at the beginning of a line.  Comments can also exist at the end of a line,
as seen in the
.Sx EXAMPLES
section, below.
.Sh FILES
.Bl -tag -width /etc/sysctl.conf -compact
.It Pa /etc/sysctl.conf
Initial settings for
.Xr sysctl 8 .
.El
.Sh EXAMPLE
To turn off logging of programs that exit due to fatal signals you may use
a configuration like
.Bd -literal -offset indent
# Configure logging.
kern.logsigexit=0	# Do not log fatal signal exits (e.g. sig 11)
.Ed
.Sh SEE ALSO
.Xr rc.conf 5 ,
.Xr rc 8 ,
.Xr sysctl 8
.Sh HISTORY
The
.Nm
file appeared in
.Fx 4.0 .
.Sh BUGS
If loadable kernel modules are used to introduce additional kernel
functionality and sysctls to manage that functionality, sysctl.conf may
be processed too early in the boot process to set those sysctls.
For example, sysctls to manage the linux emulator cannot be set in
sysctl.conf if the linux emulator is loaded as a module rather than
compiled into the kernel.
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.\" Copyright (c) 1999 Chris Costello <chris@FreeBSD.org>`
			`.\" All rights reserved.`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`.\"`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.\" Redistribution and use in source and binary forms, with or without`
			`.\" modification, are permitted provided that the following conditions`
			`.\" are met:`
			`.\" 1. Redistributions of source code must retain the above copyright`
			`.\" notice, this list of conditions and the following disclaimer.`
			`.\" 2. Redistributions in binary form must reproduce the above copyright`
			`.\" notice, this list of conditions and the following disclaimer in the`
			`.\" documentation and/or other materials provided with the distribution.`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`.\"`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
			`.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE`
			`.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE`
			`.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE`
			`.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL`
			`.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS`
			`.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)`
			`.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT`
			`.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY`
			`.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF`
			`.\" SUCH DAMAGE.`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`.\"`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.\" $FreeBSD$`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`.\"`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.Dd December 30, 1999`
			`.Dt SYSCTL.CONF 5`
mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 15:31:11 +00:00			`.Os`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.Sh NAME`
			`.Nm sysctl.conf`
mdoc(7) police: normalize .Nd. 2001-04-18 15:54:10 +00:00			`.Nd kernel state defaults`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.Sh DESCRIPTION`
			`The`
			`.Pa /etc/sysctl.conf`
			`file is read in when the system goes into multi-user mode to set default`
			`settings for the kernel. The`
			`.Pa /etc/sysctl.conf`
			`is in the format of the`
Since the ``-w'' sysctl(8) option has been deprecated, don't mention it in the manpages. 2001-07-30 14:18:14 +00:00			`.Xr sysctl 8`
mdoc(7) police: protect trailing full stops of abbreviations with a trailing zero-width space: `e.g.\&'. 2001-08-10 13:45:36 +00:00			`command, i.e.\&`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.Bd -literal -offset indent`
			`sysctl_mib=value`
			`.Ed`
Add and document support for handling comments and blank lines in /etc/sysctl.conf. Reviewed by: imp, jkh 2000-01-16 18:12:42 +00:00			`.Pp`
			`Comments are denoted by a`
			`.Dq #`
			`at the beginning of a line. Comments can also exist at the end of a line,`
			`as seen in the`
			`.Sx EXAMPLES`
			`section, below.`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.Sh FILES`
			`.Bl -tag -width /etc/sysctl.conf -compact`
			`.It Pa /etc/sysctl.conf`
			`Initial settings for`
			`.Xr sysctl 8 .`
Prepare for mdoc(7)NG. 2000-12-29 09:18:45 +00:00			`.El`
o sysctl.conf cannot be used to set sysctls that are present in unloaded kernel modules. Remove the example linux compat sysctls because they break if the linux emulator is loaded as a module, rather than compiled in. Add a BUGS entry indicating as much. Reported by: jack <jack@germanium.xtalwind.net> MFC after: 3 days 2001-12-24 20:18:45 +00:00			`.Sh EXAMPLE`
			`To turn off logging of programs that exit due to fatal signals you may use`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`a configuration like`
			`.Bd -literal -offset indent`
o sysctl.conf cannot be used to set sysctls that are present in unloaded kernel modules. Remove the example linux compat sysctls because they break if the linux emulator is loaded as a module, rather than compiled in. Add a BUGS entry indicating as much. Reported by: jack <jack@germanium.xtalwind.net> MFC after: 3 days 2001-12-24 20:18:45 +00:00			`# Configure logging.`
Add and document support for handling comments and blank lines in /etc/sysctl.conf. Reviewed by: imp, jkh 2000-01-16 18:12:42 +00:00			`kern.logsigexit=0 # Do not log fatal signal exits (e.g. sig 11)`
Add and active the manual page for /etc/sysctl.conf. 1999-12-31 02:08:37 +00:00			`.Ed`
			`.Sh SEE ALSO`
			`.Xr rc.conf 5 ,`
			`.Xr rc 8 ,`
mdoc(7) police: removed punctuation after the last SEE ALSO xref. 2001-07-10 18:00:19 +00:00			`.Xr sysctl 8`
Add HISTORY. 2000-07-27 22:55:44 +00:00			`.Sh HISTORY`
			`The`
			`.Nm`
			`file appeared in`
			`.Fx 4.0 .`
o sysctl.conf cannot be used to set sysctls that are present in unloaded kernel modules. Remove the example linux compat sysctls because they break if the linux emulator is loaded as a module, rather than compiled in. Add a BUGS entry indicating as much. Reported by: jack <jack@germanium.xtalwind.net> MFC after: 3 days 2001-12-24 20:18:45 +00:00			`.Sh BUGS`
			`If loadable kernel modules are used to introduce additional kernel`
			`functionality and sysctls to manage that functionality, sysctl.conf may`
			`be processed too early in the boot process to set those sysctls.`
			`For example, sysctls to manage the linux emulator cannot be set in`
			`sysctl.conf if the linux emulator is loaded as a module rather than`
			`compiled into the kernel.`