From 3dff25b0b52efab04c9b058effdef3646f8c9dc4 Mon Sep 17 00:00:00 2001 From: brooks Date: Sat, 10 Dec 2005 02:24:47 +0000 Subject: [PATCH] Sync with HEAD. - bump the date to represent the addition of ipv4_addrs_. - ru's -mdoc sweep - bring in documentation of NOAUTO - remove obsolete documentation of dead removable_interfaces --- share/man/man5/rc.conf.5 | 99 ++++++++++++++++++++++++++++++---------- 1 file changed, 75 insertions(+), 24 deletions(-) diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5 index c521304d06e0..6575ed798735 100644 --- a/share/man/man5/rc.conf.5 +++ b/share/man/man5/rc.conf.5 @@ -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__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__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 ,