OK, it's time to introduce the rc.conf(5) man page and kick the

now-obsolete sysconfig(5) man page out.  If you add new rc.conf variables,
folks, please try to remember to keep the man page up to date.  Thanks!
PR:		4398

2 files changed, 3 insertions, 374 deletions

diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile
index a34dcdf..df1b712 100644
--- a/share/man/man5/Makefile
+++ b/share/man/man5/Makefile
@@ -3,9 +3,9 @@
 #MISSING: dump.5 plot.5
 MAN5=	a.out.5 acct.5 core.5 devfs.5 dir.5 disktab.5 ethers.5 fs.5 fbtab.5 \
 	fdesc.5 forward.5 fstab.5 group.5 hosts.5 intro.5 link.5 kernfs.5 \
-	motd.5 networks.5 passwd.5 pbm.5 phones.5 \
-	printcap.5 procfs.5 protocols.5 remote.5 resolver.5 services.5 \
-	shells.5 stab.5 sysconfig.5 types.5 utmp.5 hosts.equiv.5 hosts.lpd.5
+	motd.5 networks.5 passwd.5 pbm.5 phones.5 printcap.5 \
+	procfs.5 protocols.5 rc.conf.5 remote.5 resolver.5 services.5 \
+	shells.5 stab.5 types.5 utmp.5 hosts.equiv.5 hosts.lpd.5
 MLINKS=	fs.5 inode.5 utmp.5 wtmp.5 utmp.5 lastlog.5 dir.5 dirent.5 \
 	resolver.5 resolv.conf.5 hosts.equiv.5 rhosts.5
 
diff --git a/share/man/man5/sysconfig.5 b/share/man/man5/sysconfig.5
deleted file mode 100644
index c28ac4e..0000000
--- a/share/man/man5/sysconfig.5
+++ /dev/null
@@ -1,371 +0,0 @@
-.\" 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$
-.\"
-.Dd December 18, 1995
-.Dt SYSCONFIG 5
-.Os FreeBSD 2.0.5
-.Sh NAME
-.Nm sysconfig
-.Nd local configuration information.
-.Sh DESCRIPTION
-The file
-.Nm sysconfig
-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 sysconfig
-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/sysconfig -compact
-.It Pa /etc/sysconfig
-.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 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 chose 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 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 defaultdomainname
-(str) The NIS domainname of your host, or
-.Ar NO
-if you're not running NIS.
-.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 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 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 routedflags
-(str) Set to the arguments you wish to invoke the
-.Xr routed 8
-command
-with or
-.Ar NO
-if you do not wish to run routed.  This command is generally only
-useful in networks where the active exchange of RIP information is encouraged.
-.It Ar timedflags
-(str) Set to the arguments you wish to invoke the 
-.Xr timed 8
-command with or
-.Ar NO
-if you do not wish to run timed.  This command is intended for networks
-of machines where a consistent 
-.Qq "network time"
-for all of them 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 xntpdflags
-(str) Set to the arguments you wish to invoke the 
-.Xr xntpd 8
-command
-with or
-.Ar NO
-if you do not wish to run xntpd.  This command is intended for applications
-where more precise time synchronization is required.
-.It Ar ntpdate
-(str) Set to the arguments you wish to invoke the 
-.Xr ntpdate 8
-command with or
-.Ar NO
-if you do not wish to initialize the time with ntpdate.  This command is
-intended to synchronize the system clock only 
-.Ar once
-from some standard
-server.  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 rwhod
-(bool) Set to
-.Ar YES
-if you want to run the 
-.Xr rwhod 8
-command.
-.It Ar sendmail_flags
-(str) Set to the arguments you wish to invoke the 
-.Xr sendmail 8
-command with or
-.Ar NO
-if you do not wish to run sendmail.  This command should be run by any
-host wishing to send and receive electronic mail and is enabled by
-default.
-.It Ar amdflags
-(str) Set to the arguments you wish to invoke the 
-.Xr amd 8 
-command with or
-.Ar NO
-if you do not wish to run amd.  This command implements an
-`auto-mount' scheme using NFS and can help prevent the ``spaghetti
-mount'' problem often encountered in large computational clusters.
-Read the man page or see the 
-.Xr info 1
-section for AMD.
-.It Ar nfs_client
-(bool) Set to 
-.Ar YES
-if this host will be an NFS client.
-.It Ar nfs_server
-(bool) Set to 
-.Ar YES
-if this host will be an NFS server.  Note:  This also requires an
-.Xr exports 5
-file.
-.It Ar nis_ypsetflags
-(str) Set to the arguments you wish to invoke the 
-.Xr ypset 8
-command with or
-.Ar NO
-if you do not wish to run NIS as a client.
-.It Ar nis_serverflags
-(str) Set to the arguments you wish to invoke the 
-.Xr ypserv 8
-command with or
-.Ar NO
-if you do not wish to run an NIS server.
-.It Ar namedflags
-(str) Set to the arguments you wish to invoke the 
-.Xr named 8
-command with or
-.Ar NO
-if you do not wish to run a name server (if you don't even know what
-this means, then you definitely don't).
-.It Ar pcnfsd
-(str) Set to the arguments you wish to invoke the 
-.Xr pcnfsd 8
-command with or
-.Ar NO
-if you do not wish to support ONC clients on DOS, OS/2, Macintosh,
-etc) machines.  Note that enabling this currently also requires that
-you install the optional pcnfsd package.  See the networking section
-of any reasonably recent package archive or the net subdirectory of
-the ports collection.
-.It Ar apache_httpd
-(bool) If set to
-.Ar YES
-then the 
-.Ar "Apache web server"
-will be started at system initial
-boot time.  Note that enabling this currently also requires that you
-install the optional apache WWW server package.  See the net or www sections
-of any reasonably recent package archive or the www subdirectory of
-the ports collection.
-.It Ar xtend
-(bool) If set to
-.Ar YES
-then the X-10 power controller daemon (the
-.Xr xtend 8 
-command) will be started
-at system initial boot time.
-.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 savecore
-(bool) Set to
-.Ar YES
-if you want kernel crash-dumps to go to
-.Ar dumpdev
-for later post-mortem diagnosis with the 
-.Xr gdb 1
-command's 
-.Fl k
-flag.
-.It Ar kerberos_server
-(bool) Set to
-.Ar YES
-if you want to run a Kerberos authentication server.
-.It Ar gateway
-(bool) Set to
-.Ar YES
-if this host is expected to gateway packets between interfaces (e.g. serve as
-some sort of packet router).
-.It Ar gated
-(bool) Set to
-.Ar YES
-if you want to run the 
-.Xr gated 8
-route management system at system
-initial boot time.  Note that enabling this currently also requires that
-you install the optional gated package.  See the networking section
-of any reasonably recent package archive or the net subdirectory of
-the ports collection.
-.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
-(bool) Set to
-.Ar YES
-if you wish to enable system accounting through the 
-.Xr accton 8
-facility.
-.It Ar ibcs2
-(bool) Set to
-.Ar YES
-if you wish to enable iBCS2 (SCO) binary emulation at system initial boot
-time.
-.Sh SEE ALSO
-.Xr gdb 1 ,
-.Xr info 1 ,
-.Xr exports 5 ,
-.Xr accton 8 ,
-.Xr amd 8 ,
-.Xr gated 8 ,
-.Xr named 8 ,
-.Xr ntpdate 8 ,
-.Xr pcnfsd 8 ,
-.Xr quotacheck 8 ,
-.Xr rc 8 ,
-.Xr route 8 ,
-.Xr routed 8 ,
-.Xr rwhod 8 ,
-.Xr sendmail 8 ,
-.Xr timed 8 ,
-.Xr xntpd 8 ,
-.Xr xtend 8 ,
-.Xr ypserv 8 ,
-.Xr ypset 8
-.Sh HISTORY
-The
-.Nm
-file appeared in
-.Fx 2.0.5 .
-.Sh AUTHOR
-Jordan K. Hubbard.