372 lines
10 KiB
Groff
372 lines
10 KiB
Groff
.\" 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.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.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.
|