1.\" $OpenBSD: rc.conf.8,v 1.9 2000/09/08 13:17:41 aaron Exp $ 2.\" 3.\" Copyright (c) 1997 Ian F. Darwin 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. The name of the author may not be used to endorse or promote 15.\" products derived from this software without specific prior written 16.\" permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 19.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 20.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY 22.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" 30.Dd January 5, 1998 31.Dt RC.CONF 8 32.Os 33.Sh NAME 34.Nm rc.conf 35.Nd system daemon configuration database 36.Sh DESCRIPTION 37This file contains a series of Bourne-shell syntax assignments 38that are used to configure the system daemons. 39It is not read by the kernel, but is sourced by various other files 40in the 41.Pa /etc/rc.* 42series in order to set shell variables used therein 43to control the behaviour of the scripts. 44.Pp 45As an alternative, it is also possible to leave the 46.Pa /etc/rc.conf 47file untouched, and instead create and edit a new 48.Pa /etc/rc.conf.local 49file. 50Variables set in this file will override variables previously set in 51.Pa /etc/rc.conf . 52.Pp 53There are three sections in this file. 54The first is used to turn features on or off. 55For example, whether the system runs the 56.Nm sendmail 57daemon is determined by the line in this section 58.Bd -literal -indent xxx 59sendmail_flags=NO 60.Ed 61.Pp 62If this line is edited to contain some valid sendmail daemon command-line 63flags, such as 64.Bd -literal -indent xxx 65sendmail_flags="-bd -q30m" 66.Ed 67.Pp 68then the sendmail daemon will be started with those options. 69.Pp 70The second section contains some other programs that can either be run or not, 71but that don't need options. 72They can be set to YES or NO. 73For example, the line 74.Bd -literal -indent xxx 75nfs_server=NO 76.Ed 77.Pp 78prevents the NFS server daemons from starting. 79To run NFS, just change this line's value from NO to YES, 80.Sy and 81also make whatever changes are needed for the server 82to have something to do (set up the 83.Xr exports 5 84file etc.). 85.Pp 86The third section contains values that parameterize servers started by 87one of the first two sections, and are ignored if the corresponding 88server is not running. 89For example, if 90.Nm nfs_server , 91is enabled, then the line 92.Bd -literal -indent xxx 93nfsd_flags="-tun 4" 94.Ed 95provides command-line arguments for the NFS server. 96.Pp 97This particular line instructs 98.Xr nfsd 8 99to start four copies of the server. 100On a busy file server, 8 (or more) copies are recommended. 101.Sh SEE ALSO 102.Xr init 8 , 103.Xr rc 8 104.Pp 105and the detailed documentation given for each server that is 106configurable in this fashion. 107.Sh HISTORY 108The 109.Nm 110file first appeared in 111.Ox 2.2 . 112