Sync with HEAD.

- bump the date to represent the addition of ipv4_addrs_<ifn>.
 - ru's -mdoc sweep
 - bring in documentation of NOAUTO
 - remove obsolete documentation of dead removable_interfaces
This commit is contained in:
brooks 2005-12-10 02:24:47 +00:00
parent 24b555483a
commit 3dff25b0b5

View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd September 15, 2005
.Dd December 10, 2005
.Dt RC.CONF 5
.Os
.Sh NAME
@ -215,10 +215,6 @@ is set to
these are the flags to pass to the
.Xr powerd 8
daemon.
.It Va removable_interfaces
.Pq Vt str
List of removable network interfaces to be supported by
.Pa /etc/pccard_ether .
.It Va tmpmfs
Controls the creation of a
.Pa /tmp
@ -241,7 +237,7 @@ utility when the memory file system for
.Pa /tmp
is created.
The default is
.Dq Li -S -M ,
.Dq Li "-S -M" ,
which inhibits the use of softupdates on
.Pa /tmp
to waste as little space as possible
@ -273,7 +269,7 @@ utility when the memory file system for
.Pa /var
is created.
The default is
.Dq Li -S -M ,
.Dq Li "-S -M" ,
which inhibits the use of softupdates on
.Pa /var
to waste as little space as possible
@ -321,7 +317,7 @@ this variable should be set to an empty string.
.It Va ipv6_enable
.Pq Vt bool
Enable support for IPv6 networking.
Note that this requires that the kernel have been compiled with
Note that this requires that the kernel has been compiled with
.Cd "options INET6" .
.It Va nisdomainname
.Pq Vt str
@ -348,7 +344,7 @@ manpage for a description of the command line options available.
.Pq Vt bool
Set to
.Dq Li YES
to start the dhcp client in background.
to start the DHCP client in background.
This can cause trouble with applications depending on
a working network, but it will provide a faster startup
in many cases.
@ -927,24 +923,50 @@ Refer to
for more information.
.It Va network_interfaces
.Pq Vt str
Set to the list of network interfaces to configure on this host or
.Dq Li "AUTO"
Set to the list of network interfaces to configure on this host or
.Dq Li AUTO
(the default) for all current interfaces.
For example, if the only network devices in the system are the loopback
device
For example, if the only active network devices in the system
are the loopback device
.Pq Li lo0
and a NIC using the
.Xr ed 4
driver,
this could be set to
.Dq Li "lo0 ed0" .
.Pp
An
.Va ifconfig_ Ns Aq Ar interface
variable is also assumed to exist for each value of
.Ar interface .
It is also possible to add IP alias entries here in cases where
multiple IP addresses registered against a single interface
are desired.
The variable can contain arguments to
.Xr ifconfig 8 ,
as well as special case-insensitive keywords described below.
Such keywords are removed before passing the value to
.Xr ifconfig 8
while the order of the other arguments is preserved.
.Pp
One can configure more than one IPv4 address with the
.Va ipv4_addrs_ Ns Aq Ar interface
variable.
One or more IP addresses must be provided in Classless Inter-Domain
Routing (CIDR) address notation, whose last byte can be a range like
192.168.0.5-23/24.
In this case the address 192.168.0.5 will be configured with the
netmask /24 and the addresses 192.168.0.6 to 192.168.0.23 with
the non-conflicting netmask /32 as explained in the
.Xr ifconfig 8
alias section.
With the interface in question being
.Li ed0 ,
an example could look like:
.Bd -literal
ipv4_addrs_ed0="192.168.0.1/24 192.168.1.1-5/28"
.Ed
.Pp
It is also possible to add IP alias entries using
.Xr ifconfig 8
syntax.
Assuming that the interface in question was
.Li ed0 ,
it might look
@ -972,7 +994,12 @@ ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff"
Then note that alias4 would
.Em not
be added since the search would
stop with the missing alias3 entry.
stop with the missing
.Dq Li alias3
entry.
Due to this difficult to manage behavior, the
.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
form is deprecated.
.Pp
If the
.Pa /etc/start_if. Ns Aq Ar interface
@ -985,6 +1012,18 @@ and
.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
variables.
.Pp
If the
.Va ifconfig_ Ns Aq Ar interface
contains the keyword
.Dq Li NOAUTO
then the interface will not be configured
at boot or by
.Pa /etc/pccard_ether
when
.Va network_interfaces
is set to
.Dq Li AUTO .
.Pp
It is possible to bring up an interface with DHCP by adding
.Dq Li DHCP
to the
@ -1022,7 +1061,7 @@ In addition to the
form, a fallback variable
.Va ifconfig_DEFAULT
may be configured.
It will be used for all interfaces no
It will be used for all interfaces with no
.Va ifconfig_ Ns Aq Ar interface
variable.
This is intended to replace the no longer supported
@ -1214,7 +1253,7 @@ Default flags to use by
.Xr geli 8
when configuring disk encryption.
Flags can be configured for every device separately by defining
.Va geli_<device>_flags
.Va geli_ Ns Ao Ar device Ac Ns Va _flags
variable.
.It Va geli_autodetach
.Pq Vt str
@ -1223,14 +1262,14 @@ file systems are mounted.
Default is
.Dq Li YES .
This can be changed for every device separately by defining
.Va geli_<device>_autodetach
.Va geli_ Ns Ao Ar device Ac Ns Va _autodetach
variable.
.It Va geli_swap_flags
Options passed to the
.Xr geli 8
utility when encrypted GEOM providers for swap partitions are created.
The default is
.Dq Li -a aes -l 256 -s 4096 -d .
.Dq Li "-a aes -l 256 -s 4096 -d" .
.It Va root_rw_mount
.Pq Vt bool
Set to
@ -2877,7 +2916,7 @@ The names specified in this list will be used to
identify settings common to an instance of a jail.
Assuming that the jail in question was named
.Li vjail ,
you would have the following dependant variables:
you would have the following dependent variables:
.Bd -literal
jail_vjail_hostname="jail.example.com"
jail_vjail_ip="192.168.1.100"
@ -2912,7 +2951,7 @@ If set to
.Dq Li NO ,
unaligned access warnings will not be printed.
(alpha)
.\" ----- isdn settings ---------------------------------
.\" ----- ISDN settings ---------------------------------
.It Va isdn_enable
.Pq Vt bool
Set to
@ -3208,7 +3247,8 @@ This is configured via
.Xr sysctl 8
variable
.Va kern.init_shutdown_timeout
and defaults to 120 seconds. Setting the value of
and defaults to 120 seconds.
Setting the value of
.Va rcshutdown_timeout
to more than 120 seconds will have no effect until the
.Xr sysctl 8
@ -3331,6 +3371,9 @@ device and the mount point will be changed.
.Xr vi 1 ,
.Xr vidcontrol 1 ,
.Xr ip 4 ,
.Xr ipf 4 ,
.Xr ipfw 4 ,
.Xr ipnat 4 ,
.Xr kld 4 ,
.Xr pf 4 ,
.Xr pflog 4 ,
@ -3338,8 +3381,11 @@ device and the mount point will be changed.
.Xr tcp 4 ,
.Xr udp 4 ,
.Xr exports 5 ,
.Xr ipf 5 ,
.Xr ipnat 5 ,
.Xr motd 5 ,
.Xr newsyslog.conf 5 ,
.Xr pf.conf 5 ,
.Xr accton 8 ,
.Xr amd 8 ,
.Xr apm 8 ,
@ -3350,6 +3396,9 @@ device and the mount point will be changed.
.Xr dhclient 8 ,
.Xr ifconfig 8 ,
.Xr inetd 8 ,
.Xr ipf 8 ,
.Xr ipfw 8 ,
.Xr ipnat 8 ,
.Xr isdnd 8 ,
.Xr isdntrace 8 ,
.Xr kldxref 8 ,
@ -3366,6 +3415,8 @@ device and the mount point will be changed.
.Xr ntpd 8 ,
.Xr ntpdate 8 ,
.Xr pcnfsd 8 ,
.Xr pfctl 8 ,
.Xr pflogd 8 ,
.Xr powerd 8 ,
.Xr quotacheck 8 ,
.Xr quotaon 8 ,