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