.\"	$NetBSD: rc.conf.5,v 1.31 2000/02/13 07:47:27 itojun Exp $
.\"
.\" Copyright (c) 1996 Matthew R. Green
.\" Copyright (c) 1997 Curt J. Sampson
.\" Copyright (c) 1997 Michael W. Long
.\" Copyright (c) 1998, 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This document is derived from works contributed to The NetBSD Foundation
.\" by Luke Mewburn.
.\"
.\" 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 November 23, 1999
.Dt RC.CONF 5
.Os
.\" turn off hyphenation
.hym 999
.Sh NAME
.Nm rc.conf
.Nd system startup configuration file
.Sh DESCRIPTION
The
.Nm
file specifies which services are enabled during system startup by
the startup script
.Pa /etc/rc .
The
.Nm
file is a shell script that is sourced by
.Pa /etc/rc
if it exists, meaning that
.Nm
must contain valid shell commands.
.Pp
Listed below are the
.Nm
variables that may be set, the values to which each may be set,
a brief description of what each variable does, and a reference to
relevant manual pages.
.Pp
Most variables are one of two types: enabling variables or flags
variables.
Enabling variables, such as
.Sy inetd ,
are generally named after the program or the system they enable,
and are set to "YES" or "NO".
Flags variables, such as
.Sy inetd_flags
have the same name with "_flags" appended, and determine what
arguments are passed to the program if it is enabled.
.Pp
If a variable that
.Pa /etc/rc
expects to be set is not set, or the value is not one of the allowed
values, a warning will be printed.
.Pp
.Ss Basic network configuration:
.Bl -tag -width net_interfaces
.It Sy hostname
Name of host.
If empty or not set, then the contents of
.Pa /etc/myname
(if it exists) are used.
.It Sy domainname
.Tn NIS
(YP) domain of host.
If empty or not set, then the contents of
.Pa /etc/defaultdomain
(if it exists) are used.
.It Sy defaultroute
Default network route.
If empty or not set, then the contents of
.Pa /etc/mygate
(if it exists) are used.
.El
.Pp
.Ss Boottime file-system and swap configuration:
.Bl -tag -width critfs_require_network
.It Sy critical_filesystems
File systems mounted very early in the system boot, except for the
.Pa /usr
and
.Pa /var
file-systems.
.It Sy critfs_require_network
YES or NO.
Set the 
.Sy critfs_require_network
variable to YES if the network must be configured before critical filesystems
can be mounted.   This should be set to NO if you are using the DHCP client,
because the DHCP client needs to store its lease database in the
.Pa /var/db 
directory.
.It Sy no_swap
Set the
.Sy no_swap
variable to YES if you have configured your system with no swap on purpose.
If not set, or set to anything other than YES, and no swap devices
are configured, the system will warn you.
.El
.Pp
.Ss One-time actions to perform or programs to run on boot-up:
.Bl -tag -width net_interfaces
.It Sy lkm
YES or NO.
Runs
.Pa /etc/rc.lkm .
.It Sy savecore
YES or NO.
Runs the
.Xr savecore 8
utility.
Passes
.Sy savecore_flags .
.It Sy update_motd
YES or NO.
Updates the
.Nx
version string in the
.Pa /etc/motd
file to reflect the version of the running kernel.
See
.Xr motd 5 .
.It Sy dmesg
YES or NO.
Create
.Pa /var/run/dmesg.boot
from the output of
.Xr dmesg 8 .
Passes
.Sy dmesg_flags .
.It Sy accounting
YES or NO.
Enables process accounting with
.Xr accton 8 .
Requires
.Pa /var/account/acct
to exist.
.It Sy defcorename
A string.
This sets the default core name template, from which are derived core dump
files names. The template can include format charaters which are dynamically
interpreted. See
.Xr core 5
for details of the format.
If set to nothing, the default compiled-in value is keept (see
.Xr options 4 ,
.Xr sysctl 3
).
.El
.Pp
.Ss System security setting:
.Bl -tag -width securelevel
.It Sy securelevel
A number.  The system securelevel is set to the specified value early
in the boot process, before any external logins, or other programs
that run users job, are started.  If set to nothing, the default
action is taken, as described
.Xr init 8 ,
which contains definative information about the system securelevel.
.El
.Pp
.Ss Networking startup:
.Bl -tag -width net_interfaces
.It Sy ipfilter
YES or NO.
Runs
.Xr ipf 8
to load in packet filter specifications from
.Pa /etc/ipf.conf
at network boot time, before any interfaces are configured.
See
.Xr ipf 5 .
.It Sy auto_ifconfig
YES or NO.
Sets the
.Sy net_interfaces
variable (see below) to the output of
.Xr ifconfig 8
with the
.Ar -l
flag and suppresses warnings about interfaces in this list that
do not have an ifconfig file or variable.
.It Sy net_interfaces
The list of network interfaces to be configured at boot time.
For each interface "xxn", the system first looks for ifconfig
parameters in
.Pa /etc/ifconfig.xxn
and then in the variable
.Sy ifconfig_xxn .
The contents of the file or the variable are handed to ifconfig
after the interface name.
If
.Sy auto_ifconfig
is set to "NO" and neither the file nor the variable is found,
a warning is printed.
.It Sy ifaliases_*
List of
.Sq Ar "address netmask"
pairs to configure additional network addresses for the given
configured interface
.Dq *
(e.g.
.Sy ifaliases_le0 ) .
If
.Ar netmask
is
.Dq - ,
then use the default netmask for the interface.
.Pp
.Sy ifaliases_*
covers limited cases only and considered unrecommended.
We recommend using
.Pa /etc/ifconfig.xxN
with multiple lines instead.
.It Sy flushroutes
YES or NO.
Flushes the route table on networking startup.
Useful when coming up to multiuser mode after going down to
single-user mode.
.It Sy dhclient
YES or NO.
Set to YES to configure some or all network interfaces using
the DHCP client.   If you set
.Sy dhclient
to YES, you must either set 
.Sy critfs_require_network
to NO or direct the DHCP client to store the leases file on the root
filesystem by modifying the
.Sy dhclient_flags
variable.   You must not provide ifconfig information or ifaliases
information for any interface that is to be configured using the DHCP
client.   Interface aliases can be set up in the DHCP client configuration
file if needed - see
.Xr dhclient.conf 5
for details.
.It Sy dhclient_flags
Flags to pass to the DHCP client.   See
.Xr dhclient 8
for complete documentation.   If you wish to configure all broadcast
network interfaces using the DHCP client, you can leave this blank.
To configure only specific interfaces, name the interfaces to be configured
on the command line.
.Pp
If you must run the DHCP client before mounting critical filesystems,
then you should specify an alternate location for the DHCP client's lease
file in the
.Sy dhclient_flags
variable - for example, "-lf /tmp/dhclient.leases".

.It Sy ntpdate
YES or NO.
Runs
.Xr ntpdate 8
to set the system time from one of the hosts in
.Sy ntpdate_hosts .
If
.Sy ntpdate_hosts
is empty, it will attempt to find a list of hosts in
.Pa /etc/ntp.conf .
.It Sy ppp_peers
If
.Sy ppp_peers
is not empty, then
.Pa /etc/netstart
will check each word in
.Sy ppp_peers
for a coresponding ppp configuration file in
.Pa /etc/ppp/peers
and will call
.Xr pppd 8
with the
.Dq call Sy peer
option.
.It Sy ip6mode
An IPv6 node can be a router
.Pq nodes that forward packet for others
or host
.Pq nodes that do not forward .
A host can be autoconfigured
based on the information advertised by adjacent IPv6 router.
By setting
.Sy ip6mode
to
.Dq Li router ,
.Dq Li host ,
or
.Dq Li autohost ,
you can configure your node as a router,
a non-autoconfigured host, or an autoconfigured host.
Invalid values will be ignored, and the node will be configured as
a non-autoconfigured host.
You may want to check
.Sy rtsol
and
.Sy rtsold
as well, if you set the variable to
.Li autohost .
.It Sy ip6defaultif
This configuration is just for very rare case, you can leave it empty.
IPv6 neighbor discovery specification (RFC2461 section 5.2)
says that if you have no router known to you,
you need to treat all the destination as being on-link.
.Sy ip6defaultif
configures the outgoing interface in this situation.
See
.Xr ndp 8 ,
option
.Fl I
for more detail.
The setting is for IPv6 hosts only.
It will be ignored if
.Sy ip6mode is set to
.Li router .
.It Sy rtsol
YES or NO.
Run
.Xr rtsol 8 ,
router solicitation command for IPv6 host.
On nomadic host like notebook computers, you may want to enable
.Sy rtsold
as well.
Passes
.Sy rtsol_flags .
This is only for autoconfigured IPv6 host, so set
.Sy ip6mode
to autohost if you use it.
.El
.Pp
.Ss Daemons required by other daemons:
.Bl -tag -width net_interfaces
.It Sy inetd
YES or NO.
Runs the
.Xr inetd 8
daemon to start network server processes (as listed in
.Pa /etc/inetd.conf )
as necessary.
Passes
.Sy inetd_flags .
The
.Ar -l
flag turns on libwrap connection logging.
.It Sy portmap
YES or NO.
The
.Xr portmap 8
daemon is required for any
.Xr rpc 3
services.
These include NFS,
.Tn NIS ,
.Xr bootparamd 8 ,
.Xr rstatd 8 ,
.Xr rusersd 8 ,
and
.Xr rwalld 8 .
.El
.Pp
.Ss Commonly used daemons:
.Bl -tag -width net_interfaces
.It Sy update
YES or NO.
Runs
.Xr update 8
and passes
.Sy update_flags .
.It Sy syslogd
YES or NO.
Runs
.Xr syslogd 8
and passes
.Sy syslogd_flags .
.It Sy named
YES or NO.
Runs
.Xr named 8
and passes
.Sy named_flags .
.It Sy timed
YES or NO.
Runs
.Xr timed 8
and passes
.Sy timed_flags .
The
.Ar -M
option allows
.Xr timed 8
to be a master time source as well as a slave.
If you are also running
.Xr xntpd 8 ,
only one machine running both should have the
.Ar -M
flag given to
.Xr timed 8 .
.It Sy xntpd
YES or NO.
Runs
.Xr xntpd 8
and passes
.Sy xntpd_flags .
.It Sy sendmail
YES or NO.
Runs
.Xr sendmail 8
and passes
.Sy sendmail_flags .
.It Sy lpd
YES or NO.
Runs
.Xr lpd 8
and passes
.Sy lpd_flags .
The
.Ar -l
flag will turn on extra logging.
.El
.Pp
.Ss Routing daemons:
.Bl -tag -width net_interfaces
.It Sy routed
YES or NO.
Runs
.Xr routed 8 ,
the RIP routing protocol daemon.
Passes
.Sy routed_flags .
This should be NO if
.Sy gated
is YES.
.It Sy gated
YES or NO.
Runs
.Xr gated 8 ,
the multiprotocol routing daemon.
Passes
.Sy gated_flags .
This should be NO if
.Sy routed
is YES.
.Xr gated 8
is not included with
.Nx .
.It Sy mrouted
YES or NO.
Runs
.Xr mrouted 8 ,
the DVMRP multicast routing protocol daemon.
Passes
.Sy mrouted_flags .
.It Sy route6d
YES or NO.
Runs
.Xr route6d 8 ,
the RIPng routing protocol daemon for IPv6.
Passes
.Sy route6d_flags .
.It Sy rtsold
YES or NO.
Runs
.Xr rtsold 8 ,
the IPv6 router solicitation daemon.
.Xr rtsold 8
periodically transmits router solicitation packet
to find IPv6 router on the network.
This configuration is mainly for nomadic host like notebook computers.
Stationary host should work fine with
.Sy rtsol
only.
Passes
.Sy rtsold_flags .
This is only for autoconfigured IPv6 host, so set
.Sy ip6mode
to autohost if you use it.
.El
.Pp
.Ss Daemons used to boot other hosts over a network:
.Bl -tag -width net_interfaces
.It Sy rarpd
YES or NO.
Runs
.Xr rarpd 8 ,
the reverse ARP daemon, often used to boot
.Nx
and Sun workstations.
Passes
.Sy rarpd_flags .
.It Sy bootparamd
YES or NO.
Runs
.Xr bootparamd 8 ,
the boot parameter server, with
.Sy bootparamd_flags
as options.
Used to boot
.Nx
and
.Tn "SunOS 4.x"
systems.
.It Sy dhcpd
YES or NO.
Runs
.Xr dhcpd 8 ,
the Dynamic Host Configuration Protocol (DHCP) daemon,
for assigning IP addresses to hosts and passing boot information.
Passes
.Sy dhcpd_flags .
.It Sy rbootd
YES or NO.
Runs
.Xr rbootd 8 ,
the
.Tn HP
boot protocol daemon; used for booting
.Tn HP
workstations.
Passes
.Sy rbootd_flags .
.It Sy mopd
YES or NO.
Runs
.Xr mopd 8 ,
the
.Tn DEC
.Tn MOP
protocol daemon; used for booting
.Tn VAX
and other
.Tn DEC
machines.
Passes
.Sy mopd_flags .
.It Sy rtadvd
YES or NO.
Runs
.Xr rtadvd 8 ,
the IPv6 router advertisement daemon, which is used to advertise
information about the subnet to IPv6 end hosts.
Passes
.Sy rtadvd_flags .
This is only for IPv6 router, so set
.Sy ip6forwarding
to YES if you use it.
.El
.Pp
.Ss NIS (YP) daemons:
.Bl -tag -width net_interfaces
.It Sy ypbind
YES or NO.
Runs
.Xr ypbind 8 ,
which lets
.Tn NIS
(YP) clients use information from a
.Tn NIS
server.
Passes
.Sy ypbind_flags .
.It Sy ypserv
YES or NO.
Runs
.Xr ypserv 8 ,
the
.Tn NIS
(YP) server for distributing information from certain files in
.Pa /etc .
Passes
.Sy ypserv_flags .
The
.Ar -d
flag causes it to use DNS for lookups in
.Pa /etc/hosts
that fail.
.It Sy yppasswdd
YES or NO.
Runs
.Xr yppasswdd 8 ,
which allows remote
.Tn NIS
users to update password on master server.
Passes
.Sy yppasswdd_flags .
.El
.Pp
.Ss NFS daemons and parameters:
.Bl -tag -width net_interfaces
.It Sy nfs_client
YES or NO.
Runs
.Xr nfsiod 8
to increase performance of an NFS client host.
Passes
.Sy nfsiod_flags .
.It Sy nfs_server
YES or NO.
Sets up a host to be a NFS server by running
.Xr mountd 8
and
.Xr nfsd 8 ,
and passing
.Sy mountd_flags
and
.Sy nfsd_flags
to them, respectively.
.It Sy lockd
YES or NO.
Runs
.Xr rpc.lockd 8
if either
.Sy nfs_server
or
.Sy nfs_client
is (or both are) set to YES.
Passes
.Sy lockd_flags .
.It Sy statd
YES or NO.
Runs
.Xr rpc.statd 8 ,
a status monitoring daemon used when
.Xr rpc.lockd 8
is running, if either
.Sy nfs_server
or
.Sy nfs_client
is (or both are) set to YES.
Passes
.Sy statd_flags .
.It Sy amd
YES or NO.
Runs
.Xr amd 8 ,
the automounter daemon, which automatically mounts NFS file systems
whenever a file or directory within that filesystem is accessed.
Passes
.Sy amd_flags .
.It Sy amd_dir
The
.Xr amd 8
mount directory.
Used only if
.Sy amd
is set to YES.
.It Sy amd_master
The
.Xr amd 8
automounter master map.
Used only if
.Sy amd
is set to YES.
.El
.Pp
.Ss X Window System daemons:
.Bl -tag -width net_interfaces
.It Sy xfs
YES or NO.
Runs the
.Xr xfs 1
X11 font server, which supplies local X font files to X terminals.
.It Sy xdm
YES or NO.
Runs the
.Xr xdm 1
X display manager.
These X daemons are available only with the optional X distribution of
.Nx .
.El
.Pp
.Ss Other daemons:
.Bl -tag -width net_interfaces
.It Sy apmd
YES or NO.
Runs
.Xr apmd 8
and passes
.Sy apmd_flags .
.It Sy rwhod
YES or NO.
Runs
.Xr rwhod 8
to support the
.Xr rwho 1
and
.Xr ruptime 1
commands.
.It Sy kerberos
YES or NO.
Runs the kerberos server
.Xr kerberos 8
and the kerberos admininstration server,
.Xr kadmind 8 .
This should only be run on the kerberos master server.
Both servers implement version IV of the Kerberos protocol, not the
newer Kerberos version 5.
The kerberos server is only available with the USA distribution of
.Nx .
.It Sy screenblank
YES or NO.
Runs
.Xr screenblank 1
and passes
.Sy screenblank_flags .
.El
.Sh FILES
.Pa /etc/rc.conf
.Sh SEE ALSO
.Xr boot 8 ,
.Xr rc 8
.Sh HISTORY
The
.Nm
file appeared in
.Nx 1.3 .