1240 lines
29 KiB
Groff
1240 lines
29 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 April 26, 1997
|
|
.Dt RC.CONF 5
|
|
.Os FreeBSD 2.2.2
|
|
.Sh NAME
|
|
.Nm rc.conf
|
|
.Nd system 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
|
|
The purpose of
|
|
.Nm rc.conf
|
|
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
|
|
.Pa /etc/rc.conf
|
|
file is included from the file
|
|
.Pa /etc/defaults/rc.conf ,
|
|
which specifies the default settings for all the available options.
|
|
Options
|
|
need only be specified in
|
|
.Pa /etc/rc.conf
|
|
when the system administrator wishes to override these defaults.
|
|
The file
|
|
.Pa /etc/rc.conf.local
|
|
is used to override settings in
|
|
.Pa /etc/rc.conf
|
|
for historical reasons.
|
|
See the
|
|
.Dq rc_conf_files
|
|
option below.
|
|
.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 apmd_enable
|
|
(bool) Run
|
|
.Xr apmd 8
|
|
to handle APM event from userland.
|
|
This also enable support for APM.
|
|
.It Ar apmd_flags
|
|
(str) If
|
|
.Ar apmd_enable
|
|
is set to
|
|
.Ar YES ,
|
|
these are the flags to pass to the
|
|
.Xr apmd 8
|
|
daemon.
|
|
.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 arguments to be passed to ifconfig(8) at boot time or on
|
|
insertion of of the card (e.g. "inet 192.168.1.1 netmask 255.255.255.0"
|
|
for a fixed address or "DHCP" for a DHCP client).
|
|
.It Ar pccard_conf
|
|
(str) Path to the configuration file for the
|
|
.Xr pccardd 8
|
|
daemon (e.g.
|
|
.Ar /etc/pccard.conf.sample ) .
|
|
.It Ar pccardd_flags
|
|
(str) If
|
|
.Ar pccard_enable
|
|
is set to
|
|
.Ar YES ,
|
|
these are the flags to pass to the
|
|
.Xr pccardd 8
|
|
daemon.
|
|
.It Ar local_startup
|
|
(str) List of directories to search for startup script files.
|
|
.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 are not connected to a network. If you are using
|
|
.Xr dhclient 8
|
|
to set your hostname via DHCP, this variable should be set to an empty string.
|
|
.It Ar nisdomainname
|
|
(str) The NIS domainname of your host, or
|
|
.Ar NO
|
|
if you are not running NIS.
|
|
.It Ar dhcp_program
|
|
(str) Path to the DHCP client progam (/sbin/dhclient, the ISC DHCP client,
|
|
is the default).
|
|
.It Ar dhcp_flags
|
|
(str) Additional flags to pass to the DHCP client program.
|
|
For the ISC DHCP client, see the
|
|
.Xr dhclient 8
|
|
page for a description of the command line options available.
|
|
.It Ar firewall_enable
|
|
(bool) Set to
|
|
.Ar NO
|
|
if you do not want have firewall rules loaded at startup, or
|
|
.Ar YES
|
|
if you do.
|
|
If set to
|
|
.Ar YES ,
|
|
and the kernel was not built with IPFIREWALL, the ipfw
|
|
kernel module will be loaded.
|
|
.It Ar firewall_script
|
|
(str) If you want to run a firewall script other than
|
|
.Pa /etc/rc.firewall ,
|
|
set this variable to the full path to that script.
|
|
.It Ar firewall_type
|
|
(str) Names the firewall type from the selection in
|
|
.Pa /etc/rc.firewall ,
|
|
or the file which contains the local firewall ruleset. Valid selections
|
|
from
|
|
.Pa /etc/rc.firewall ,
|
|
are
|
|
.Dq open
|
|
- unrestricted IP access;
|
|
.Dq closed
|
|
- all IP services disabled, except via lo0;
|
|
.Dq client
|
|
- basic protection for a workstation;
|
|
.Dq simple
|
|
- basic protection for a LAN. If a filename is specified, the full path
|
|
must be given.
|
|
.It Ar firewall_quiet
|
|
(bool) Set to
|
|
.Ar YES
|
|
to disable the display of ipfw rules on the console during boot.
|
|
.It Ar firewall_logging
|
|
(bool) Set to
|
|
.Ar YES
|
|
to enable ipfw event logging.
|
|
This is equivalent to the IPFIREWALL_VERBOSE kernel option.
|
|
.It Ar natd_program
|
|
(str) path to
|
|
.Xr natd 8 .
|
|
.It Ar natd_enable
|
|
(bool) Set to
|
|
.Ar YES
|
|
to enable natd.
|
|
.Ar Firewall_enable
|
|
must also be set to
|
|
.Ar YES ,
|
|
and
|
|
.Xr divert 4
|
|
sockets must be enabled in your kernel.
|
|
.It Ar natd_interface
|
|
This is the name of the public interface on which natd should run. It
|
|
is mandatory if
|
|
.Ar natd_enable
|
|
is set to
|
|
.Ar YES .
|
|
The interface may be given as an interface name or as an IP address.
|
|
.It Ar natd_flags
|
|
Additional natd flags should be placed here. The
|
|
.Fl n
|
|
or
|
|
.Fl a
|
|
flag is automatically added with the above
|
|
.Ar natd_interface
|
|
as an argument.
|
|
.It Ar tcp_extensions
|
|
(bool) Set to
|
|
.Ar NO
|
|
by default.
|
|
Setting this to YES enables certain TCP options as described by
|
|
.Rs
|
|
.%T RFC 1323
|
|
.Re
|
|
If you have problems with connections
|
|
randomly hanging or other weird behavior of such nature, you might
|
|
try setting this back 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 log_in_vain
|
|
(bool) Set to
|
|
.Ar NO
|
|
by default.
|
|
Setting to YES will enable logging of connection attempts to ports that
|
|
have no listening socket on them.
|
|
.It Ar tcp_keepalive
|
|
(bool) Set to
|
|
.Ar YES
|
|
by default.
|
|
Setting to NO will disable probing idle TCP connections to verify that the
|
|
peer is still up and reachable.
|
|
.It Ar tcp_drop_synfin
|
|
(bool) Set to
|
|
.Ar NO
|
|
by default.
|
|
Setting to YES will cause the kernel to ignore TCP frames that have both
|
|
the SYN and FIN flags set.
|
|
This prevents OS fingerprinting, but may
|
|
break some legitimate applications.
|
|
This option is only available if the
|
|
kernel was built with the TCP_DROP_SYNFIN option.
|
|
.It Ar tcp_restrict_rst
|
|
(bool) Set to
|
|
.Ar NO
|
|
by default.
|
|
Setting to YES will cause the kernel to refrain from emitting TCP RST frames
|
|
in response to invalid TCP packets (e.g. frames destined for closed ports).
|
|
This option is only available if the kernel was built with the
|
|
TCP_RESTRICT_RST option.
|
|
.It Ar icmp_drop_redirect
|
|
(bool) Set to
|
|
.Ar NO
|
|
by default.
|
|
Setting to YES will cause the kernel to ignore ICMP REDIRECT packets.
|
|
.It Ar icmp_log_redirect
|
|
(bool) Set to
|
|
.Ar NO
|
|
by default.
|
|
Setting to YES will cause the kernel to log ICMP REDIRECT packets.
|
|
Note that
|
|
the log messages are not rate-limited, so this option should only be used
|
|
for troubleshooting your own network.
|
|
.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
|
|
.Em not
|
|
be added since the search would
|
|
stop with the missing alias3 entry.
|
|
.Pp
|
|
You can bring up an interface with DHCP by setting the
|
|
.No ifconfig_ Ns Em interface
|
|
variable to
|
|
.Dq DHCP .
|
|
For instance, to initialize your ed0 device via DHCP,
|
|
you might have something like:
|
|
.Bd -literal
|
|
ifconfig_ed0="DHCP"
|
|
.Ed
|
|
.It Ar ppp_enable
|
|
(bool) If set to
|
|
.Ar YES ,
|
|
run the
|
|
.Xr ppp 8
|
|
daemon.
|
|
.It Ar ppp_mode
|
|
(str) Mode in which to run the
|
|
.Xr ppp 8
|
|
daemon. Accepted modes are
|
|
.Ar auto , ddial , direct
|
|
and
|
|
.Ar dedicated .
|
|
See the manual for a full description.
|
|
.It Ar ppp_nat
|
|
(bool) If set to
|
|
.Ar YES ,
|
|
enables packet aliasing.
|
|
Used in conjunction with
|
|
.Ar gateway_enable
|
|
allows hosts on private network addresses access to the Internet using
|
|
this host as a network address translating router.
|
|
.It Ar ppp_profile
|
|
(str) The name of the profile to use from
|
|
.Ar /etc/ppp/ppp.conf .
|
|
.It Ar rc_conf_files
|
|
(str) This option is used to specify a list of files that will override
|
|
the settings in
|
|
.Pa /etc/defaults/rc.conf .
|
|
The files will be read in the order in which they are specified and should
|
|
include the full path to the file.
|
|
By default, the files specified are
|
|
.Pa /etc/rc.conf
|
|
and
|
|
.Pa /etc/rc.conf.local
|
|
.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_program
|
|
(str) path to
|
|
.Xr named 8
|
|
(default
|
|
.Pa /usr/sbin/named ) .
|
|
.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 kadmind_server_enable
|
|
.Ar YES
|
|
if you want to run
|
|
.Xr kadmind 8
|
|
the Kerberos Administration Daemon); set to
|
|
.Ar NO
|
|
on a slave server.
|
|
.It Ar kerberos_stash
|
|
(str)
|
|
If
|
|
.Ar YES ,
|
|
instruct the Kerberos servers to use the stashed master key instead of
|
|
prompting for it (only if
|
|
.Ar kerberos_server_enable
|
|
is set to
|
|
.Ar YES ,
|
|
and is used for both
|
|
.Xr kerberos 1
|
|
and
|
|
.Xr kadmind 8 ).
|
|
.It Ar rwhod_enable
|
|
(bool) If set to
|
|
.Ar YES ,
|
|
run the
|
|
.Xr rwhod 8
|
|
daemon at boot time.
|
|
.It Ar rwhod_flags
|
|
(str) If
|
|
.Ar rwhod_enable
|
|
is set to
|
|
.Ar YES ,
|
|
these are the flags to pass to it.
|
|
.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.
|
|
See the
|
|
.Xr amd 8
|
|
.Xr info 1
|
|
page for more information.
|
|
.It Ar update_motd
|
|
(bool) If set to
|
|
.Ar YES ,
|
|
.Pa /etc/motd
|
|
will be updated at boot time to reflect the kernel release
|
|
bring run. If set to
|
|
.Ar NO ,
|
|
.Pa /etc/motd
|
|
will not be updated
|
|
.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_access_cache
|
|
if
|
|
.Ar nfs_client_enable
|
|
is set to
|
|
.Ar YES ,
|
|
this can be set to
|
|
.Ar 0
|
|
to disable NFS ACCESS RPC caching, or to the number of seconds for which NFS ACCESS
|
|
results should be cached. A value of 2-10 seconds will substantially reduce network
|
|
traffic for many NFS operations.
|
|
.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 single_mountd_enable
|
|
(bool) If set to
|
|
.Ar YES ,
|
|
and no
|
|
.Ar nfs_server_enable
|
|
is set, start
|
|
.Xr mountd 8 ,
|
|
but not
|
|
.Xr nfsd 8
|
|
daemon.
|
|
It is commonly needed to run CFS without real NFS used.
|
|
.It Ar weak_mountd_authentication
|
|
(bool) If set to
|
|
.Ar YES ,
|
|
allow services like PCNFSD to make non-privileged mount
|
|
requests.
|
|
.It Ar nfs_privport
|
|
(bool) If set to
|
|
.Ar YES ,
|
|
provide NFS services only on a secure port.
|
|
.It Ar nfs_bufpackets
|
|
(integer) If set to a number, indicates the number of packets worth of
|
|
socket buffer space to reserve on an NFS client. If set to
|
|
.Ar DEFAULT ,
|
|
the kernel default is used (typically 4). Using a higher number may be
|
|
useful on gigabit networks to improve performance. The minimum value is
|
|
2 and the maximum is 64.
|
|
.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_program
|
|
(str) path to
|
|
.Xr portmap 8
|
|
(default
|
|
.Pa /usr/sbin/portmap ) .
|
|
.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 pppoed_enable
|
|
(bool) If set to
|
|
.Ar YES
|
|
then run the
|
|
.Xr pppoed 8
|
|
daemon at boot time to provide PPP over Ethernet services.
|
|
.It Ar pppoed_provider
|
|
.Xr pppoed 8
|
|
listens to requests to this
|
|
.Ar provider
|
|
and ultimately runs
|
|
.Xr ppp 8
|
|
with a
|
|
.Ar system
|
|
argument of the same name.
|
|
.It Ar pppoed_flags
|
|
Additional flags to pass to
|
|
.Xr pppoed 8 .
|
|
.It Ar pppoed_interface
|
|
The network interface to run pppoed on. This is mandatory when
|
|
.Ar pppoed_enable
|
|
is set to
|
|
.Dq YES .
|
|
.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_program
|
|
(str) path to
|
|
.Xr ntpdate 8
|
|
(default
|
|
.Pa /usr/sbin/ntpdate ) .
|
|
.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_program
|
|
(str) path to
|
|
.Xr xntpd 8
|
|
(default
|
|
.Pa /usr/sbin/xntpd ) .
|
|
.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 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
|
|
.Em element
|
|
in the value, a
|
|
.No route_ Ns element
|
|
variable is assumed to exist
|
|
whose contents will later be passed to a
|
|
.Dq 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 mrouted_flags
|
|
(str) If
|
|
.Ar mrouted_enable
|
|
is set to
|
|
.Ar YES ,
|
|
these are the flags to pass to the multicast routing daemon.
|
|
.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 arpproxy_all
|
|
If set to
|
|
.Ar YES
|
|
then enable global proxy ARP.
|
|
.It Ar forward_sourceroute
|
|
If set to
|
|
.Ar YES
|
|
then when
|
|
.Ar gateway_enable
|
|
is also set to
|
|
.Ar YES ,
|
|
source routed packets are forwarded.
|
|
.It Ar accept_sourceroute
|
|
If set to
|
|
.Ar YES
|
|
then the system will accept source routed packets directed at it.
|
|
.It Ar rarpd_enable
|
|
(bool) If set to
|
|
.Ar YES
|
|
then run the
|
|
.Xr rarpd 8
|
|
daemon at system boot time.
|
|
.It Ar rarpd_flags
|
|
(str) If
|
|
.Ar rarpd_enable
|
|
is set to
|
|
.Ar YES ,
|
|
these are the flags to pass to the
|
|
.Xr rarpd 8
|
|
daemon.
|
|
.It Ar atm_enable
|
|
(bool) Set to
|
|
.Ar YES
|
|
to enable the configuration of ATM interfaces at system boot time.
|
|
For all of the ATM variables described below, please refer to the
|
|
.Xr atm 8
|
|
man page for further details on the available command parameters.
|
|
Also refer to the files in
|
|
.Pa /usr/share/examples/atm
|
|
for more detailed configuration information.
|
|
.It Ar atm_netif_<intf>
|
|
(str) For the ATM physical interface
|
|
.Va <intf> ,
|
|
this variable defines the name prefix and count for the ATM network interfaces to be created.
|
|
The value will be passed as the parameters of an
|
|
.Dq atm set netif Va <intf>
|
|
command.
|
|
.It Ar atm_sigmgr_<intf>
|
|
(str) For the ATM physical interface
|
|
.Va <intf> ,
|
|
this variable defines the ATM signalling manager to be used.
|
|
The value will be passed as the parameters of an
|
|
.Dq atm attach Va <intf>
|
|
command.
|
|
.It Ar atm_prefix_<intf>
|
|
(str) For the ATM physical interface
|
|
.Va <intf> ,
|
|
this variable defines the NSAP prefix for interfaces using a UNI signalling
|
|
manager. If set to
|
|
.Em ILMI ,
|
|
then the prefix will automatically be set via the
|
|
.Xr ilmid 8
|
|
daemon. Otherwise, the value will be passed as the parameters of an
|
|
.Dq atm set prefix Va <intf>
|
|
command.
|
|
.It Ar atm_macaddr_<intf>
|
|
(str) For the ATM physical interface
|
|
.Va <intf> ,
|
|
this variable defines the MAC address for interfaces using a UNI signalling
|
|
manager. If set to
|
|
.Em NO ,
|
|
then the hardware MAC address contained in the ATM interface card will be used.
|
|
Otherwise, the value will be passed as the parameters of an
|
|
.Dq atm set mac Va <intf>
|
|
command.
|
|
.It Ar atm_arpserver_<netif>
|
|
(str) For the ATM network interface
|
|
.Va <netif> ,
|
|
this variable defines the ATM address for a host which is to provide ATMARP
|
|
service. This variable is only applicable to interfaces using a UNI signalling
|
|
manager. If set to
|
|
.Em local ,
|
|
then this host will become an ATMARP server.
|
|
The value will be passed as the parameters of an
|
|
.Dq atm set arpserver Va <netif>
|
|
command.
|
|
.It Ar atm_scsparp_<netif>
|
|
(bool) If set to
|
|
.Em YES ,
|
|
then SCSP/ATMARP service for the network interface
|
|
.Va <netif>
|
|
will be initiated using the
|
|
.Xr scspd 8
|
|
and
|
|
.Xr atmarpd 8
|
|
daemons. This variable is only applicable if
|
|
.So
|
|
.No atm_arpserver_ Ns Va <netif>
|
|
.No Ns = Ns Qq local
|
|
.Sc
|
|
is defined.
|
|
.It Ar atm_pvcs
|
|
(str) Set to the list of ATM PVCs you would like to add at system
|
|
boot time. For each whitespace separated
|
|
.Em element
|
|
in the value, an
|
|
.No atm_pvc_ Ns Em element
|
|
variable is assumed to exist. The value of each of these variables
|
|
will be passed as the parameters of an
|
|
.Dq atm add pvc
|
|
command.
|
|
.It Ar atm_arps
|
|
(str) Set to the list of permanent ATM ARP entries you would like to add
|
|
at system boot time. For each whitespace separated
|
|
.Em element
|
|
in the value, an
|
|
.No atm_arp_ Ns Em element
|
|
variable is assumed to exist. The value of each of these variables
|
|
will be passed as the parameters of an
|
|
.Dq atm add arp
|
|
command.
|
|
.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_enable
|
|
(str) If set to
|
|
.Ar YES ,
|
|
the
|
|
.Xr moused 8
|
|
daemon is started for doing cut/paste selection on the console.
|
|
.It Ar moused_type
|
|
(str) This is the protocol type of mouse you would like to use.
|
|
This variable must be set if
|
|
.Ar moused_enable
|
|
is set to
|
|
.Ar YES .
|
|
The
|
|
.Xr moused 8
|
|
daemon
|
|
is able to detect the appropriate mouse type automatically in many cases.
|
|
You can set this variable to
|
|
.Ar auto
|
|
to let the daemon detect it, or
|
|
select one from the following list if the automatic detection fails.
|
|
.Pp
|
|
If your mouse is attached to the PS/2 mouse port, you should
|
|
always choose
|
|
.Ar auto
|
|
or
|
|
.Ar ps/2 ,
|
|
regardless of the brand and model of the mouse. Likewise, if your
|
|
mouse is attached to the bus mouse port, choose
|
|
.Ar auto
|
|
or
|
|
.Ar busmouse .
|
|
All other protocols are for serial mice and will not work with
|
|
the PS/2 and bus mice.
|
|
If you have a USB mouse,
|
|
.Ar auto
|
|
is the only protocol type which works with the USB mouse.
|
|
.Bd -literal
|
|
microsoft Microsoft mouse (serial)
|
|
intellimouse Microsoft IntelliMouse (serial)
|
|
mousesystems Mouse systems Corp mouse (serial)
|
|
mmseries MM Series mouse (serial)
|
|
logitech Logitech mouse (serial)
|
|
busmouse A bus mouse
|
|
mouseman Logitech MouseMan and TrackMan (serial)
|
|
glidepoint ALPS GlidePoint (serial)
|
|
thinkingmouse Kensignton ThinkingMouse (serial)
|
|
ps/2 PS/2 mouse
|
|
mmhittab MM HitTablet (serial)
|
|
x10mouseremote X10 MouseRemote (serial)
|
|
versapad Interlink VersaPad (serial)
|
|
|
|
.Ed
|
|
Even if your mouse is not in the above list, it may be compatible
|
|
with one in the list.
|
|
Refer to the man page for
|
|
.Xr moused 8
|
|
for compatibility information.
|
|
.Pp
|
|
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 sysmouse type mouse, since all
|
|
mouse data is converted to this single canonical format when
|
|
using
|
|
.Xr moused 8 .
|
|
If the client program does not support the sysmouse type,
|
|
specify the mousesystems type.
|
|
It is the second prefered type.
|
|
.It Ar moused_port
|
|
(str) If
|
|
.Ar moused_enable
|
|
is set to
|
|
.Ar YES ,
|
|
this is the actual port the mouse is on.
|
|
It might be
|
|
.Pa /dev/cuaa0
|
|
for a COM1 serial mouse,
|
|
.Pa /dev/psm0
|
|
for a PS/2 mouse or
|
|
.Pa /dev/mse0
|
|
for a bus 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 allscreens_flags
|
|
(str) If set,
|
|
.Xr vidcontrol 1
|
|
is run with these options for each of the virtual terminals
|
|
.Pq Pa /dev/ttyv* .
|
|
For example,
|
|
.Ar -m on
|
|
will enable the mouse pointer on all virtual terminals
|
|
if
|
|
.Ar moused_enable
|
|
is set to
|
|
.Ar YES .
|
|
.It Ar cron_enable
|
|
(bool) If set to
|
|
.Ar YES
|
|
then run the
|
|
.Xr cron 8
|
|
daemon at system boot time.
|
|
.It Ar lpd_program
|
|
(str) path to
|
|
.Xr lpd 8
|
|
(default
|
|
.Pa /usr/sbin/lpd ) .
|
|
.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 dumpdev
|
|
(str) If not set to
|
|
.Ar NO
|
|
then point kernel crash-dumps at the swap device
|
|
specified as
|
|
.Em value .
|
|
When the system restarts,
|
|
a crash-dump found on the specified device
|
|
will typically be stored in the
|
|
.Pa /var/crash
|
|
directory by the
|
|
.Xr savecore 8
|
|
program.
|
|
.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 clear_tmp_enable
|
|
(bool) Set to
|
|
.Ar YES
|
|
if you want
|
|
.Pa /tmp
|
|
to be cleaned at startup.
|
|
.It Ar ldconfig_paths
|
|
(str) Set to the list of shared library paths to use with
|
|
.Xr ldconfig 8 .
|
|
NOTE:
|
|
.Pa /usr/lib
|
|
will always be added first, so it need not appear in this list.
|
|
.It Ar kern_securelevel_enable
|
|
(bool) Set to
|
|
.Ar YES
|
|
if you wish to set the kernel security level at system startup.
|
|
.It Ar kern_securelevel
|
|
(int) The kernel security level to set at startup.
|
|
The allowed range of
|
|
.Ar value
|
|
ranges from -1 (the compile time default) to 3 (the
|
|
most secure). See
|
|
.Xr init 8
|
|
for the list of possible security levels and their effect
|
|
on system operation.
|
|
.It Ar start_vinum
|
|
(bool) Set to
|
|
.Ar YES
|
|
if you want to start
|
|
.Xr vinum 8
|
|
at system boot time.
|
|
.Sh FILES
|
|
.Bl -tag -width /etc/defaults/rc.conf -compact
|
|
.It Pa /etc/defaults/rc.conf
|
|
.El
|
|
.Pp
|
|
.Bl -tag -width /etc/rc.conf -compact
|
|
.It Pa /etc/rc.conf
|
|
.El
|
|
.Pp
|
|
.Bl -tag -width /etc/rc.conf.local -compact
|
|
.It Pa /etc/rc.conf.local
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr catman 1 ,
|
|
.Xr makewhatis 1 ,
|
|
.Xr gdb 1 ,
|
|
.Xr info 1 ,
|
|
.Xr exports 5 ,
|
|
.Xr motd 5 ,
|
|
.Xr accton 8 ,
|
|
.Xr amd 8 ,
|
|
.Xr apm 8 ,
|
|
.Xr atm 8 ,
|
|
.Xr cron 8 ,
|
|
.Xr dhclient 8 ,
|
|
.Xr gated 8 ,
|
|
.Xr ifconfig 8 ,
|
|
.Xr inetd 8 ,
|
|
.Xr lpd 8 ,
|
|
.Xr moused 8 ,
|
|
.Xr mrouted 8 ,
|
|
.Xr named 8 ,
|
|
.Xr nfsd 8 ,
|
|
.Xr nfsiod 8 ,
|
|
.Xr ntpdate 8 ,
|
|
.Xr pcnfsd 8 ,
|
|
.Xr portmap 8 ,
|
|
.Xr quotacheck 8 ,
|
|
.Xr rc 8 ,
|
|
.Xr route 8 ,
|
|
.Xr routed 8 ,
|
|
.Xr rpc.lockd 8 ,
|
|
.Xr rpc.statd 8 ,
|
|
.Xr rwhod 8 ,
|
|
.Xr savecore 8 ,
|
|
.Xr sendmail 8 ,
|
|
.Xr sysctl 8 ,
|
|
.Xr syslogd 8 ,
|
|
.Xr swapon 8 ,
|
|
.Xr tickadj 8 ,
|
|
.Xr timed 8 ,
|
|
.Xr vinum 8 ,
|
|
.Xr vnconfig 8 ,
|
|
.Xr xntpd 8 ,
|
|
.Xr xtend 8 ,
|
|
.Xr ypbind 8 ,
|
|
.Xr ypserv 8 ,
|
|
.Xr ypset 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
file appeared in
|
|
.Fx 2.2.2 .
|
|
.Sh AUTHORS
|
|
.An Jordan K. Hubbard .
|