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