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
This commit is contained in:
Jordan K. Hubbard
parent
5f4feab696
commit
cf8c9b1128
@ -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
|
||||
|
||||
|
||||
@ -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.
|
||||
Loading…
x
Reference in New Issue
Block a user