xref: /netbsd-src/share/man/man5/sysctl.conf.5 (revision 267197ec1eebfcb9810ea27a89625b6ddf68e3e7)
1.\"	$NetBSD: sysctl.conf.5,v 1.1 2007/10/05 18:49:43 reed Exp $
2.\"
3.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of The NetBSD Foundation nor the names of its
15.\"    contributors may be used to endorse or promote products derived
16.\"    from this software without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd October 4, 2007
31.Dt SYSCTL.CONF 5
32.Os
33.Sh NAME
34.Nm sysctl.conf
35.Nd sysctl configuration file
36.Sh SYNOPSIS
37.Nm
38.Sh DESCRIPTION
39The
40.Nm
41file defines the
42.Xr sysctl 7
43kernel state tunables that can be set at boot time using
44.Xr sysctl 8
45(using the
46.Fl f
47switch)
48via the
49.Pa /etc/rc.d/sysctl
50startup script.
51.Pp
52The state to be set is described using a
53.Dq Management Information Base
54.Pq Dq MIB
55style name.
56The MIB and value must be separated by
57.Sq =
58with no whitespace, for example:
59.Pp
60.Ar name Ns Li = Ns Ar value
61.Pp
62Blank lines, lines with just
63.Ar name ,
64and comments (beginning with
65.Sq # )
66are ignored.
67Line continuations using backslash
68.Sq \e
69are permitted.
70Only integral and string values can be set.
71.\"
72.Sh FILES
73.Bl -tag -width /etc/sysctl.conf -compact
74.It Pa /etc/sysctl.conf
75The file
76.Nm
77resides in
78.Pa /etc .
79.El
80.Sh EXAMPLES
81The following is an example
82.Pa /etc/sysctl.conf
83file:
84.Pp
85.Bd -literal
86# Change max open files
87kern.maxfiles=1792
88
89# Run Veriexec in IDS mode
90kern.veriexec.strict=1
91
92# Enable IP packet forwarding
93net.inet.ip.forwarding=1
94.Ed
95.Pp
96.Sh SEE ALSO
97.Xr sysctl 3 ,
98.Xr rc.conf 5 ,
99.Xr sysctl 7 ,
100.Xr sysctl 8
101.Sh HISTORY
102Support for
103.Nm
104first appeared in
105.Nx 1.5 .
106