summaryrefslogtreecommitdiff
path: root/static/openbsd/man8/rc.conf.8
diff options
context:
space:
mode:
Diffstat (limited to 'static/openbsd/man8/rc.conf.8')
-rw-r--r--static/openbsd/man8/rc.conf.8237
1 files changed, 237 insertions, 0 deletions
diff --git a/static/openbsd/man8/rc.conf.8 b/static/openbsd/man8/rc.conf.8
new file mode 100644
index 00000000..e076ec29
--- /dev/null
+++ b/static/openbsd/man8/rc.conf.8
@@ -0,0 +1,237 @@
+.\" $OpenBSD: rc.conf.8,v 1.31 2022/09/25 22:47:27 kn Exp $
+.\"
+.\" Copyright (c) 1997 Ian F. Darwin
+.\" Copyright (c) 2014 Ingo Schwarze <schwarze@openbsd.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.
+.\" 3. The name of the author may not be used to endorse or promote
+.\" products derived from this software without specific prior written
+.\" permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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.
+.\"
+.Dd $Mdocdate: September 25 2022 $
+.Dt RC.CONF 8
+.Os
+.Sh NAME
+.Nm rc.conf ,
+.Nm rc.conf.local
+.Nd system daemon configuration database
+.Sh DESCRIPTION
+The file
+.Nm rc.conf
+contains a series of variable assignments that are used to configure
+the system daemons.
+These variables are read by
+.Xr rc 8
+early on in the boot sequence and every time an
+.Xr rc.d 8
+script is executed.
+.Pp
+It is advisable to leave
+.Nm rc.conf
+untouched, and instead create and edit a new
+.Nm rc.conf.local
+file or use the
+.Xr rcctl 8
+utility.
+Since only the last assignment to any variable takes effect,
+variables set in this file override variables previously set in
+.Nm rc.conf .
+.Pp
+.Nm rc.conf
+is made up of variable assignments
+.Pq Ar variable Ns = Ns Ar value
+with comments designated by a hash mark
+.Pq Sq # .
+.Pp
+.Sy Base system daemon
+configuration variables are used to enable and disable daemon programs
+that are installed by default, and to set their command line options.
+.Pp
+All of these variables follow the format
+.Dq Ar daemon Ns _flags
+where
+.Ar daemon
+is the name of one of the
+.Xr rc.d 8
+daemon control scripts.
+The list of base system daemons, including the information whether
+they are enabled by default, can be displayed with this command:
+.Pp
+.Dl grep _flags /etc/rc.conf
+.Pp
+If one of these variables is set to
+.Cm NO ,
+the respective
+.Ar daemon
+is disabled.
+If set to the empty string, the
+.Ar daemon
+is run with the default command line arguments defined in its
+.Xr rc.d 8
+.Ar daemon
+script, or without command line arguments if no such default exists.
+If set to any other value, including a string containing
+only a single blank character, the
+.Ar daemon
+is run with those command line arguments.
+.Pp
+.Sy Package daemon
+configuration variables are used to enable and disable
+daemon programs installed from
+.Xr packages 7 ,
+and to set their command line options.
+.Pp
+The special
+.Cm pkg_scripts
+variable lists
+.Xr rc.d 8
+.Ar daemon
+control scripts to be started in the specified order.
+For each
+.Ar daemon
+listed, its default command line options can optionally be overridden
+using the variable
+.Ar daemon Ns _flags
+as described above.
+.Pp
+.Sy Base system service
+configuration variables control features available by default
+that are not implemented as daemons.
+They can be set to either
+.Cm YES
+or
+.Cm NO .
+When set to
+.Cm YES ,
+they have the following effects:
+.Bl -tag -width check_quotas
+.It Cm accounting
+rc calls:
+.Xr accton 8
+.Pa /var/account/acct
+.It Cm check_quotas
+rc calls:
+.Xr quotacheck 8
+.Fl a ;
+.Xr quotaon 8
+.Fl a
+.It Cm ipsec
+rc calls:
+.Xr ipsecctl 8
+.Fl f Pa /etc/ipsec.conf
+.It Cm library_aslr
+rc reorders some libraries for improved protection against ROP.
+.It Cm multicast
+See
+.Xr multicast 4 .
+.It Cm pf
+rc calls:
+.Xr pfctl 8
+.Fl ef Pa /etc/pf.conf
+.It Cm spamd_black
+The script
+.Pa /etc/rc.d/spamd
+uses
+.Fl b
+in front of any other configured command line arguments when running
+.Xr spamd 8
+and
+.Xr spamd-setup 8 .
+.El
+.Pp
+.Sy Auxiliary
+configuration variables mostly determine
+the locations of specific configuration files.
+The boot scripts use them as follows:
+.Bl -tag -width amd_master
+.It Cm amd_master
+The
+.Xr amd 8
+master map file.
+The script
+.Pa /etc/rc.d/amd
+appends its content to the command line when starting the auto mounter daemon.
+.It Cm shlib_dirs
+Extra shared library search path entries.
+rc calls:
+.Xr ldconfig 8
+.Pa /usr/X11R6/lib
+.Pa /usr/local/lib
+.Pf $ Brq Ar shlib_dirs
+.It Cm savecore_flags
+rc calls:
+.Xr savecore 8
+.Pf $ Brq Ar savecore_flags
+.Pa /var/crash
+.El
+.Sh EXAMPLES
+Do not start the
+.Xr dhcpd 8
+daemon when booting the system:
+.Bd -literal -offset indent
+dhcpd_flags=NO
+.Ed
+.Pp
+To run the dhcpd daemon,
+add the following line to
+.Nm rc.conf.local :
+.Bd -literal -offset indent
+dhcpd_flags=
+.Ed
+.Pp
+To start it with some options:
+.Bd -literal -offset indent
+dhcpd_flags=-A abandoned
+.Ed
+.Pp
+Run
+.Pa /etc/rc.d/messagebus
+then
+.Pa /etc/rc.d/cupsd
+with the
+.Cm start
+argument at boot time,
+and in reverse order with the
+.Cm stop
+argument at shutdown:
+.Bd -literal -offset indent
+pkg_scripts=messagebus cupsd
+.Ed
+.Pp
+The default location of the
+.Xr amd 8
+master map file is:
+.Bd -literal -offset indent
+amd_master=/etc/amd/master # AMD 'master' map
+.Ed
+.Sh SEE ALSO
+.Xr init 8 ,
+.Xr intro 8 ,
+.Xr rc 8 ,
+.Xr rc.d 8 ,
+.Xr rcctl 8
+.Sh HISTORY
+The
+.Nm
+file first appeared in
+.Ox 2.2 .