From c58afa5621d78c7c082c97781882086367e0ba5d Mon Sep 17 00:00:00 2001
From: "Jordan K. Hubbard" <jkh@FreeBSD.org>
Date: Thu, 11 Sep 1997 14:31:55 +0000
Subject: [PATCH] D'oh!  It works better if you remember to cvs add the file
 first! ;)

---
 share/man/man5/rc.conf.5 | 692 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 692 insertions(+)
 create mode 100644 share/man/man5/rc.conf.5

diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5
new file mode 100644
index 000000000000..2bd94000ba1f
--- /dev/null
+++ b/share/man/man5/rc.conf.5
@@ -0,0 +1,692 @@
+.\" Copyright (c) 1995
+.\"	Jordan K. Hubbard
+.\"
+.\" 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.
+.\"
+.\" 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.
+.\"
+.\"     $Id: rc.conf.5,v 1.5.2.3 1997/02/28 03:27:26 mpp Exp $
+.\"
+.Dd April 26, 1997
+.Dt RC.CONF 5
+.Os FreeBSD 2.2.2
+.Sh NAME
+.Nm rc.conf
+.Nd local configuration information.
+.Sh DESCRIPTION
+The file
+.Nm rc.conf
+contains descriptive information about the local host name, configuration
+details for any potential network interfaces and which services should be
+started up at system initial boot time.  In new installations, the
+.Nm rc.conf
+file is generally initialized by the system installation utility:
+.Pa /stand/sysinstall .
+.Pp
+It is the duty of the system administrator to properly maintain this file
+as changes occur on the local host.
+.Sh FILES
+.Bl -tag -width /etc/rc.conf -compact
+.It Pa /etc/rc.conf
+.El
+.Sh DESCRIPTION
+The purpose of
+.Nm
+is not to run commands or perform system startup actions
+directly.  Instead, it is included by the
+various generic startup scripts in
+.Pa /etc
+which conditionalize their
+internal actions according to the settings found there.
+.Pp
+The following list provides a name and short description for each
+variable you can set in the
+.Nm
+file:
+.Bl -tag -width Ar
+.It Ar swapfile
+(str) If set to
+.Ar NO
+then no swapfile is installed, otherwise the value is used as the full
+pathname to a file to use for additional swap space.
+.It Ar apm_enable
+(bool) If set to
+.Ar YES ,
+enable support for Automatic Power Management with
+the
+.Xr apm 8
+command.
+.It Ar pccard_enable
+(bool) If set to
+.Ar YES ,
+enable PCCARD support at boot time.
+.It Ar pccard_mem
+(str) Set to PCCARD controller memory address or
+.Ar DEFAULT
+for the default value.
+.It Ar pccard_ifconfig
+(str) List of ethernet devices (e.g.
+.Ar "ed0 ed1 ep0 ..." )
+which should be dynamically ifconfig'd on insertion or boot.
+.It Ar local_startup
+(str) List of directories to search for startup script files.
+.It Ar local_periodic
+(str) List of directories to search for periodic scripts (3.0 only).
+.It Ar hostname
+(str) The Fully Qualified Domain Name of your host on the network.
+This should almost certainly be set to something meaningful, even if
+you've no network connected.
+.It Ar nisdomainname
+(str) The NIS domainname of your host, or
+.Ar NO
+if you're not running NIS.
+.It Ar firewall
+(str) Set to
+.Ar NO
+if you don't want to use one of the firewall definitions in
+.Pa /etc/rc.firewall ,
+otherwise it should name of one of the firewalls defined there.
+.It Ar tcp_extensions
+(bool) Set to
+.Ar YES
+by default, this enables certain TCP options as described by
+Internet RFCs 1323 and 1644.  If you have problems with connections
+randomly hanging or other weird behavior of such nature, you might
+try setting this to
+.Ar NO
+and seeing if that helps.  Some hardware/software out there is known
+to be broken with respect to these options.
+.It Ar network_interfaces
+(str) Set to the list of network interfaces to configure on this host.
+For example, if you had a loopback device (standard) and an SMC Elite
+Ultra NIC, you might have this set to
+.Qq Ar "lo0 ed0"
+for the two interfaces.  An 
+.No ifconfig_ Ns Em interface
+variable is also assumed to exist for each value of 
+.Em interface .
+It is also possible to add IP alias entries here in cases where you
+want a single interface to have multiple IP addresses registered against
+it.
+Assuming that the interface in question was ed0, it might look
+something like this:
+.Bd -literal
+ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff" 
+ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff"
+
+.Ed
+And so on.  For each ifconfig_<interface>_alias<n> entry that is
+found, its contents are passed to
+.Xr ifconfig 8 .
+Execution stops at the first unsuccessful access, so if you
+had something like:
+.Bd -literal
+ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff"
+ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff"
+ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff"
+ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff"
+
+.Ed
+Then note that alias4 would \fBnot\fR be added since the search would
+stop with the missing alias3 entry.
+.It Ar syslogd_enable
+(bool) If set to
+.Ar YES ,
+run the
+.Xr syslogd 8
+daemon.
+.It Ar syslogd_flags
+(str) if syslogd_enable is set to
+.Ar YES ,
+these are the flags to pass to
+.Xr syslogd 8 .
+.It Ar inetd_enable
+(bool) If set to
+.Ar YES ,
+run the
+.Xr inetd 8
+daemon.
+.It Ar inetd_flags
+(str) if inetd_enable is set to
+.Ar YES ,
+these are the flags to pass to
+.Xr inetd 8 .
+.It Ar named_enable
+(bool) If set to
+.Ar YES ,
+run the
+.Xr named 8
+daemon.
+.It Ar named_flags
+(str) if
+.Ar named_enable
+is set to
+.Ar YES ,
+these are the flags to pass to
+.Xr named 8 .
+.It Ar kerberos_server_enable
+(bool) Set to
+.Ar YES
+if you want to run a Kerberos authentication server
+at boot time.
+.It Ar rwhod_enable
+(bool) If set to
+.Ar YES ,
+run the
+.Xr rwhod 8
+daemon at boot time.
+.It Ar amd_enable
+(bool) If set to
+.Ar YES ,
+run the
+.Xr amd 8
+daemon at boot time.
+.It Ar amd_flags
+(str) If
+.Ar amd_enable
+is set to
+.Ar YES ,
+these are the flags to pass to it.  Use the \fBinfo amd\fR
+command for more information.
+.It Ar nfs_client_enable
+(bool) If set to
+.Ar YES ,
+run the NFS client daemons at boot time.
+.It Ar nfs_client_flags
+(str) If
+.Ar nfs_client_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr nfsiod 8
+daemon.
+.It Ar nfs_server_enable
+(bool) If set to
+.Ar YES ,
+run the NFS server daemons at boot time.
+.It Ar nfs_server_flags
+(str) If
+.Ar nfs_server_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr nfsd 8
+daemon.
+.It Ar weak_mountd_authentication
+(bool) If set to
+.Ar YES ,
+allow services like \fBPCNFSD\fR to make non-privileged mount
+requests.
+.It Ar nfs_reserved_port_only
+(bool) If set to
+.Ar YES ,
+provide NFS services only on a secure port.
+.It Ar rcp_lockd_enable
+(bool) If set to
+.Ar YES
+and also an NFS server, run
+.Xr rpc.lockd 8
+at boot time.
+.It Ar rcp_statd_enable
+(bool) If set to
+.Ar YES
+and also an NFS server, run
+.Xr rpc.statd 8
+at boot time.
+.It Ar portmap_enable
+(bool) If set to
+.Ar YES ,
+run the
+.Xr portmap 8
+service at boot time.
+.It Ar portmap_flags
+(str) If
+.Ar portmap_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr portmap 8
+daemon.
+.It Ar xtend_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr xtend 8 
+daemon at boot time.
+.It Ar xtend_flags
+(str) If
+.Ar xtend_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr xtend 8
+daemon.
+.It Ar timed_enable
+(boot) if
+.Ar YES
+then run the
+.Xr timed 8
+service at boot time.  This command is intended for networks of
+machines where a consistent
+.Qq "network time"
+for all hosts must be established.  This is often useful in large NFS
+environments where time stamps on files are expected to be consistent
+network-wide.
+.It Ar timed_flags
+(str) If
+.Ar timed_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr timed 8
+service.
+.It Ar ntpdate_enable
+(bool) If set to
+.Ar YES ,
+run ntpdate at system startup.  This command is intended to
+synchronize the system clock only
+.Ar once
+from some standard reference.  An option to set this up initially
+(from a list of known servers) is also provided by the
+.Pa /stand/sysinstall
+program when the system is first installed.
+.It Ar ntpdate_flags
+(str) If
+.Ar ntpdate_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr ntpdate 8
+command (typically a hostname).
+.It Ar xntpd_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr xntpd 8
+command at boot time.
+.It Ar xntpd_flags
+(str) If
+.Ar xntpd_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr xntpd 8
+daemon.
+.It Ar tickadj_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr tickadj 8
+command at system boot time.
+.It Ar tickadj_flags
+(str) If
+.Ar tickadj_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr tickadj 8
+command.
+.It Ar nis_client_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr ypbind 8
+service at system boot time.
+.It Ar nis_client_flags
+(str) If
+.Ar nis_client_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr ypbind 8
+service.
+.It Ar nis_ypset_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr ypset 8
+daemon at system boot time.
+.It Ar nis_ypset_flags
+(str) If
+.Ar nis_ypset_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr ypset 8
+daemon.
+.It Ar nis_server_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr ypserv 8
+daemon at system boot time.
+.It Ar nis_server_flags
+(str) If
+.Ar nis_server_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr ypserv 8
+daemon.
+.It Ar nis_ypxfrd_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr ypxfrd 8
+daemon at system boot time.
+.It Ar nis_ypxfrd_flags
+(str) If
+.Ar nis_ypxfrd_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr ypxfrd 8
+daemon.
+.It Ar nis_yppasswdd_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr yppasswdd 8
+daemon at system boot time.
+.It Ar nis_yppasswdd_flags
+(str) If
+.Ar nis_yppasswdd_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr yppasswdd 8
+daemon.
+.It Ar defaultrouter
+(str) If not set to
+.Ar NO
+then create a default route to this host name or IP address (use IP
+address value if you also require this router to get to a name
+server!)
+.It Ar static_routes
+(str) Set to the list of static routes you would like to add at system
+boot time.  If not set to
+.Ar NO
+then for each whitespace separated element in the value, a 
+.No route_ Ns em element
+variable is assumed to exist for each instance
+of 
+.Em element , 
+and will later be passed to a ``route add'' operation.
+.It Ar gateway_enable
+(bool) If set to
+.Ar YES ,
+then configure host to at as an IP router, e.g. to forward packets
+between interfaces.
+.It Ar router_enable
+(bool) If set to
+.Ar YES
+then run a routing daemon of some sort, based on the
+settings of
+.Ar router
+and
+.Ar router_flags .
+.It Ar router
+(str) If
+.Ar router_enable
+is set to
+.Ar YES ,
+this is the name of the routing daemon to use.
+.It Ar router_flags
+(str) If
+.Ar router_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the routing daemon.
+.It Ar mrouted_enable
+(bool) If set to
+.Ar YES
+then run the multicast routing daemon,
+.Xr mrouted 8 .
+.It Ar ipxgateway_enable
+(bool) If set to
+.Ar YES
+then enable the routing of IPX traffic.
+.It Ar ipxrouted_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr ipxrouted 8
+daemon at system boot time.
+.It Ar ipxrouted_flags
+(str) If
+.Ar ipxrouted_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr ipxrouted 8
+daemon.
+.It Ar keymap
+(str) If set to
+.Ar NO
+then no keymap is installed, otherwise the value is used to install
+the keymap file in 
+.Pa /usr/share/syscons/keymaps/<value>.kbd
+.It Ar keyrate
+(str) The keyboard repeat speed.  Set to
+.Ar slow ,
+.Ar normal ,
+.Ar fast
+or
+.Ar NO
+if the default behavior is desired.
+.It Ar keychange
+(str) If not set to
+.Ar NO ,
+attempt to program the function keys with the value.  The value should
+be a single string of the form:
+.Qq Ar "<funkey_number> <new_value> [<funkey_number> <new_value>]..."
+.It Ar cursor
+(str) Can be set to the value of
+.Ar normal ,
+.Ar blink ,
+.Ar destructive
+or
+.Ar NO
+to set the cursor behavior explicitly or choose the default behavior.
+.It Ar scrnmap
+(str) If set to
+.Ar NO
+then no screen map is installed, otherwise the value is used to install
+the screen map file in 
+.Pa /usr/share/syscons/scrnmaps/<value> .
+.It Ar font8x16
+(str) If set to
+.Ar NO
+then the default 8x16 font value is used for screen size requests, otherwise
+the value in 
+.Pa /usr/share/syscons/fonts/<value>
+is used.
+.It Ar font8x14
+(str) If set to
+.Ar NO
+then the default 8x14 font value is used for screen size requests, otherwise
+the value in
+.Pa /usr/share/syscons/fonts/<value>
+is used.
+.It Ar font8x8
+(str) If set to
+.Ar NO
+then the default 8x8 font value is used for screen size requests, otherwise
+the value in
+.Pa /usr/share/syscons/fonts/<value>
+is used.
+.It Ar blanktime
+(int) If set to
+.Ar NO
+then the default screen blanking interval is used, otherwise it is set
+to 
+.Ar value 
+seconds.
+.It Ar saver
+(str) If not set to
+.Ar NO ,
+this is the actual screen saver to use (blank, snake, daemon, etc).
+.It Ar moused_type
+(str) If not set to
+.Ar NO ,
+this is the type of mouse you would like to use for doing
+cut/paste selection on the console.
+It should be chosen from the following list of types:
+.Bd -literal
+microsoft        Microsoft mouse
+mousesystems     Mouse systems Corp mouse
+mmseries         MM Series mouse
+logitech         Logitech mouse
+busmouse         A bus mouse
+mouseman         Logitech MouseMan and TrackMan
+ps/2             PS/2 mouse
+mmhittab         MM HitTablet
+
+.Ed
+It should also be noted that while this is enabled, any
+other client of the mouse (such as an X server) should access
+the mouse through the virtual mouse device:
+.Pa /dev/sysmouse
+and configure it as a mousesystems type mouse, since all
+mouse data is converted to this single canonical format when
+using
+.Xr moused 8 .
+.It Ar moused_port
+(str) If
+.Ar moused_type
+is set, this is the actual port the mouse is on.
+It might be
+.Pa /dev/cuaa0
+for a COM1 serial mouse or
+.Pa /dev/psm0
+for a PS/2 mouse, for example.
+.It Ar moused_flags
+(str) If
+.Ar moused_type
+is set, these are the additional flags to pass to the
+.Xr moused 8
+daemon.
+.It Ar cron_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr cron 8
+daemon at system boot time.
+.It Ar lpd_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr lpd 8
+daemon at system boot time.
+.It Ar lpd_flags
+(str) If
+.Ar lpd_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr lpd 8
+daemon.
+.It Ar sendmail_enable
+(bool) If set to
+.Ar YES
+then run the
+.Xr sendmail 8
+daemon at system boot time.
+.It Ar sendmail_flags
+(str) If
+.Ar sendmail_enable
+is set to
+.Ar YES ,
+these are the flags to pass to the
+.Xr sendmail 8
+daemon.
+.It Ar savecore_enable
+(bool) If set to
+.Ar YES
+then save kernel crashdumps for debugging purposes when the system
+comes back up after a crash.  Crash images are typically stored in the
+.Pa /var/crash
+directory.
+.It Ar dumpdev
+(str) If not set to
+.Ar NO
+then point kernel crash-dumps at the swap device
+specified as 
+.Em value .
+.It Ar check_quotas
+(bool) Set to
+.Ar YES
+if you want to enable user disk quota checking via the 
+.Xr quotacheck 8
+command.
+.It Ar accounting_enable
+(bool) Set to
+.Ar YES
+if you wish to enable system accounting through the 
+.Xr accton 8
+facility.
+.It Ar ibcs2_enable
+(bool) Set to
+.Ar YES
+if you wish to enable iBCS2 (SCO) binary emulation at system initial boot
+time.
+.It Ar linux_enable
+(bool) Set to
+.Ar YES
+if you wish to enable Linux/ELF binary emulation at system initial
+boot time.
+.It Ar rand_irqs
+(str) Set to the list of IRQs to monitor for random number creation
+(see the man page for
+.Xr rndcontrol 8 ).
+
+.Sh SEE ALSO
+.Xr accton 8 ,
+.Xr amd 8 ,
+.Xr exports 5 ,
+.Xr gated 8 ,
+.Xr gdb 1 ,
+.Xr ifconfig 8 ,
+.Xr info 1 ,
+.Xr named 8 ,
+.Xr ntpdate 8 ,
+.Xr pcnfsd 8 ,
+.Xr quotacheck 8 ,
+.Xr rc 8 ,
+.Xr rndcontrol 8 ,
+.Xr route 8 ,
+.Xr routed 8 ,
+.Xr rwhod 8 ,
+.Xr sendmail 8 ,
+.Xr swapon 8 ,
+.Xr timed 8 ,
+.Xr vnconfig 8 ,
+.Xr xntpd 8 ,
+.Xr xtend 8 ,
+.Xr ypserv 8 ,
+.Xr ypset 8
+.Sh HISTORY
+The
+.Nm
+file appeared in
+.Bx 2.2.2 .
+
+.Sh AUTHOR
+Jordan K. Hubbard.