swift 11/08/14 16:12:14
Modified: hb-net-advanced.xml hb-net-modules.xml
hb-net-start.xml hb-net-wireless.xml
hb-working-rcscripts.xml
Log:
Bug #213988 - Various fixes on OpenRC in handbook
Revision Changes Path
1.16 xml/htdocs/doc/en/handbook/hb-net-advanced.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?rev=1.16&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?rev=1.16&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?r1=1.15&r2=1.16
Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- hb-net-advanced.xml 13 Feb 2009 04:40:27 -0000 1.15
+++ hb-net-advanced.xml 14 Aug 2011 16:12:13 -0000 1.16
@@ -4,7 +4,7 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.15
2009/02/13 04:40:27 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.16
2011/08/14 16:12:13 swift Exp $ -->
<sections>
@@ -13,8 +13,8 @@
before we learn about modular networking.
</abstract>
-<version>8.1</version>
-<date>2009-02-12</date>
+<version>9</version>
+<date>2011-08-13</date>
<section>
<title>Advanced Configuration</title>
@@ -128,44 +128,23 @@
<p>
Init scripts in <path>/etc/init.d</path> can depend on a specific network
-interface or just net. <c>net</c> can be defined in <path>/etc/conf.d/rc</path>
-to mean different things using the <c>RC_NET_STRICT_CHECKING</c> variable.
+interface or just net. All network interfaces in Gentoo's init system provide
+what is called <e>net</e>.
</p>
-<table>
-<tr>
- <th>Value</th>
- <th>Description</th>
-</tr>
-<tr>
- <ti><c>none</c></ti>
- <ti>The <path>net</path> service is always considered up</ti>
-</tr>
-<tr>
- <ti><c>no</c></ti>
- <ti>
- This basically means that at least one <path>net.*</path> service besides
- <path>net.lo</path> must be up. This can be used by notebook users that
- have a WIFI and a static NIC, and only wants one up at any given time to
- have the net service seen as up.
- </ti>
-</tr>
-<tr>
- <ti><c>lo</c></ti>
- <ti>
- This is the same as the <c>no</c> option, but <path>net.lo</path> is also
- counted. This should be useful to people that do not care about any
specific
- interface being up at boot.
- </ti>
-</tr>
-<tr>
- <ti><c>yes</c></ti>
- <ti>
- For this ALL network interfaces MUST be up for the <path>net</path> service
- to be considered up.
- </ti>
-</tr>
-</table>
+<p>
+If, in <path>/etc/rc.conf</path>, <c>rc_depend_strict="YES"</c> is set, then
all
+network interfaces that provide net must be active before a dependency on "net"
+is assumed to be met. In other words, if you have a <path>net.eth0</path> and
+<path>net.eth1</path> and an init script depends on "net", then both must be
+enabled.
+</p>
+
+<p>
+On the other hand, if <c>rc_depend_strict="NO"</c> is set, then the "net"
+dependency is marked as resolved the moment at least one network interface is
+brought up.
+</p>
<p>
But what about <path>net.br0</path> depending on <path>net.eth0</path> and
@@ -176,21 +155,19 @@
</p>
<p>
-The answer is making your own <c>depend()</c> function in
+The answer is defining an <c>rc_need_</c> setting in
<path>/etc/conf.d/net</path>.
</p>
<pre caption="net.br0 dependency in /etc/conf.d/net">
-<comment># You can use any dependency (use, after, before) as found in current
scripts</comment>
-depend_br0() {
- need net.eth0 net.eth1
-}
+rc_need_br0="net.eth0 net.eth1"
</pre>
<p>
For a more detailed discussion about dependency, consult the section <uri
link="?part=2&chap=4#doc_chap4">Writing Init Scripts</uri> in the Gentoo
-Handbook.
+Handbook. More information about <path>/etc/rc.conf</path> is available as
+comments within that file.
</p>
</body>
1.26 xml/htdocs/doc/en/handbook/hb-net-modules.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?rev=1.26&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?rev=1.26&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?r1=1.25&r2=1.26
Index: hb-net-modules.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- hb-net-modules.xml 13 Feb 2009 04:40:27 -0000 1.25
+++ hb-net-modules.xml 14 Aug 2011 16:12:13 -0000 1.26
@@ -4,7 +4,7 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.25
2009/02/13 04:40:27 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.26
2011/08/14 16:12:13 swift Exp $ -->
<sections>
@@ -13,8 +13,8 @@
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<version>8.4</version>
-<date>2009-02-12</date>
+<version>9</version>
+<date>2011-08-13</date>
<section>
<title>Network Modules</title>
@@ -41,16 +41,16 @@
<pre caption="Module preference">
<comment># Prefer iproute2 over ifconfig</comment>
-modules=( "iproute2" )
+modules="iproute2"
<comment># You can also specify other modules for an interface
# In this case we prefer pump over dhcpcd</comment>
-modules_eth0=( "pump" )
+modules_eth0="pump"
<comment># You can also specify which modules not to use - for example you may
be
# using a supplicant or linux-wlan-ng to control wireless configuration but
# you still want to configure network settings per ESSID associated
with.</comment>
-modules=( "!iwconfig" )
+modules="!iwconfig"
</pre>
</body>
@@ -74,7 +74,7 @@
# <i>emerge sys-apps/iproute2</i>
<comment># To prefer iproute2 over ifconfig if both are installed</comment>
-modules=( "iproute2" )
+modules="iproute2"
</pre>
<p>
@@ -84,12 +84,12 @@
</p>
<pre caption="ifconfig and iproute2 examples">
-config_eth0=( "192.168.0.2/24" )
-config_eth0=( "192.168.0.2 netmask 255.255.255.0" )
+config_eth0="192.168.0.2/24"
+config_eth0="192.168.0.2 netmask 255.255.255.0"
<comment># We can also specify broadcast</comment>
-config_eth0=( "192.168.0.2/24 brd 192.168.0.255" )
-config_eth0=( "192.168.0.2 netmask 255.255.255.0 broadcast 192.168.0.255" )
+config_eth0="192.168.0.2/24 brd 192.168.0.255"
+config_eth0="192.168.0.2 netmask 255.255.255.0 broadcast 192.168.0.255"
</pre>
</body>
@@ -178,9 +178,9 @@
<pre caption="Sample DHCP configuration in /etc/conf.d/net">
<comment># Only needed if you have more than one DHCP module
installed</comment>
-modules=( "dhcpcd" )
+modules="dhcpcd"
-config_eth0=( "dhcp" )
+config_eth0="dhcp"
dhcpcd_eth0="-t 10" <comment># Timeout after 10 seconds</comment>
dhcp_eth0="release nodns nontp nonis" <comment># Only get an address</comment>
</pre>
@@ -204,10 +204,6 @@
# <i>emerge net-dialup/ppp</i>
</pre>
-<note>
-If you need PPPoA, then make sure to use >=<c>baselayout-1.12.x</c>.
-</note>
-
<p>
Second, create the PPP net script and the net script for the ethernet interface
to be used by PPP:
@@ -219,7 +215,7 @@
</pre>
<p>
-Be sure to set RC_NET_STRICT_CHECKING="yes" in <path>/etc/conf.d/rc</path>.
+Be sure to set <c>rc_depend_strict</c> to "YES" in <path>/etc/rc.conf</path>.
</p>
<p>
@@ -227,26 +223,23 @@
</p>
<pre caption="A basic PPPoE setup">
-config_eth0=( null ) <comment>(Specify your ethernet interface)</comment>
-config_ppp0=( "ppp" )
+config_eth0=null <comment>(Specify your ethernet interface)</comment>
+config_ppp0="ppp"
link_ppp0="eth0" <comment>(Specify your ethernet interface)</comment>
-plugins_ppp0=( "pppoe" )
+plugins_ppp0="pppoe"
username_ppp0='user'
password_ppp0='password'
-pppd_ppp0=(
- "noauth"
- "defaultroute"
- "usepeerdns"
- "holdoff 3"
- "child-timeout 60"
- "lcp-echo-interval 15"
- "lcp-echo-failure 3"
- noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp
-)
-
-depend_ppp0() {
- need net.eth0
-}
+pppd_ppp0="
+noauth
+defaultroute
+usepeerdns
+holdoff 3
+child-timeout 60
+lcp-echo-interval 15
+lcp-echo-failure 3
+noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp"
+
+rc_need_ppp0="net.eth0"
</pre>
<p>
@@ -266,8 +259,10 @@
<impo>
Please carefully read the section on ADSL and PPP in
-<path>/etc/conf.d/net.example</path>. It contains many more detailed
-explanations of all the settings your particular PPP setup will likely need.
+<path>/usr/share/doc/openrc-0.8.3-r1/net.example.bz2</path>. It contains many
+more detailed explanations of all the settings your particular PPP setup will
+likely need. Of course, change <c>0.8.3-r1</c> with the version of OpenRC
+installed on your system.
</impo>
</body>
@@ -293,11 +288,11 @@
<pre caption="APIPA configuration in /etc/conf.d/net">
<comment># Try DHCP first - if that fails then fallback to APIPA</comment>
-config_eth0=( "dhcp" )
-fallback_eth0=( "apipa" )
+config_eth0="dhcp"
+fallback_eth0="apipa"
<comment># Just use APIPA</comment>
-config_eth0=( "apipa" )
+config_eth0="apipa"
</pre>
</body>
@@ -321,12 +316,10 @@
slaves_bond0="eth0 eth1 eth2"
<comment># You may not want to assign an IP to the bonded interface</comment>
-config_bond0=( "null" )
+config_bond0="null"
<comment># Depend on eth0, eth1 and eth2 as they may require extra
configuration</comment>
-depend_bond0() {
- need net.eth0 net.eth1 net.eth2
-}
+rc_need_bond0="net.eth0 net.eth1 net.eth2"
</pre>
</body>
@@ -348,22 +341,20 @@
<pre caption="Bridge configuration in /etc/conf.d/net">
<comment># Configure the bridge - "man brctl" for more details</comment>
-brctl_br0=( "setfd 0" "sethello 0" "stp off" )
+brctl_br0="setfd 0" "sethello 0" "stp off"
<comment># To add ports to bridge br0</comment>
bridge_br0="eth0 eth1"
<comment># You need to configure the ports to null values so dhcp does not get
started</comment>
-config_eth0=( "null" )
-config_eth1=( "null" )
+config_eth0="null"
+config_eth1="null"
<comment># Finally give the bridge an address - you could use DHCP as
well</comment>
-config_br0=( "192.168.0.1/24" )
+config_br0="192.168.0.1/24"
<comment># Depend on eth0 and eth1 as they may require extra
configuration</comment>
-depend_br0() {
- need net.eth0 net.eth1
-}
+rc_need_br0="net.eth0 net.eth1"
</pre>
<impo>
@@ -378,11 +369,8 @@
<body>
<p>
-You don't need to emerge anything for changing the MAC address of your
-interface if you have <c>sys-apps/baselayout-1.11.14</c> or newer and want to
-change to a specific MAC address. However, if you need to change to a random
MAC
-address or have a baselayout older than the version mentioned above, you have
-to emerge <c>net-analyzer/macchanger</c> to be able to make use of this
feature.
+If you need to, you can change the MAC address of your interfaces through
+the network configuration file too.
</p>
<pre caption="MAC Address change example">
@@ -424,7 +412,7 @@
iptunnel_vpn0="mode ipip remote 207.170.82.2 ttl 255"
<comment># To configure the interface</comment>
-config_vpn0=( "192.168.0.2 peer 192.168.1.1" )
+config_vpn0="192.168.0.2 peer 192.168.1.1"
</pre>
</body>
@@ -451,12 +439,12 @@
<comment># You can also configure the VLAN</comment>
<comment># see for vconfig man page for more details</comment>
-vconfig_eth0=( "set_name_type VLAN_PLUS_VID_NO_PAD" )
-vconfig_vlan1=( "set_flag 1" "set_egress_map 2 6" )
+vconfig_eth0="set_name_type VLAN_PLUS_VID_NO_PAD"
+vconfig_vlan1="set_flag 1" "set_egress_map 2 6"
<comment># Configure the interface as usual</comment>
-config_vlan1=( "172.16.3.1 netmask 255.255.254.0" )
-config_vlan2=( "172.16.2.1 netmask 255.255.254.0" )
+config_vlan1="172.16.3.1 netmask 255.255.254.0"
+config_vlan2="172.16.2.1 netmask 255.255.254.0"
</pre>
<impo>
1.10 xml/htdocs/doc/en/handbook/hb-net-start.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml?rev=1.10&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml?rev=1.10&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml?r1=1.9&r2=1.10
Index: hb-net-start.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- hb-net-start.xml 15 Apr 2010 06:17:23 -0000 1.9
+++ hb-net-start.xml 14 Aug 2011 16:12:13 -0000 1.10
@@ -4,7 +4,7 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml,v 1.9
2010/04/15 06:17:23 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml,v 1.10
2011/08/14 16:12:13 swift Exp $ -->
<sections>
@@ -13,8 +13,8 @@
environments.
</abstract>
-<version>8.1</version>
-<date>2010-04-14</date>
+<version>9</version>
+<date>2011-08-13</date>
<section>
<title>Getting started</title>
@@ -27,10 +27,6 @@
<c>eth1</c>, <c>wlan0</c>, etc.
</note>
-<note>
-This document requires you to run <c>baselayout-1.11.11</c> or better.
-</note>
-
<p>
To get started configuring your network card, you need to tell the Gentoo RC
system about it. This is done by creating a symbolic link from
@@ -51,15 +47,15 @@
<pre caption="Examples for /etc/conf.d/net">
<comment># For DHCP</comment>
-config_eth0=( "dhcp" )
+config_eth0="dhcp"
<comment># For static IP using CIDR notation</comment>
-config_eth0=( "192.168.0.7/24" )
-routes_eth0=( "default via 192.168.0.1" )
+config_eth0="192.168.0.7/24"
+routes_eth0="default via 192.168.0.1"
<comment># For static IP using netmask notation</comment>
-config_eth0=( "192.168.0.7 netmask 255.255.255.0" )
-routes_eth0=( "default via 192.168.0.1" )
+config_eth0="192.168.0.7 netmask 255.255.255.0"
+routes_eth0="default via 192.168.0.1"
</pre>
<note>
@@ -88,9 +84,9 @@
</pre>
<impo>
-When troubleshooting networking, it is recommended to set
-<c>RC_VERBOSE="yes"</c> in <path>/etc/conf.d/rc</path> so that you get more
-information about what's happening.
+When troubleshooting networking, take a look at <path>/var/log/rc.log</path>.
+Unless you have <c>rc_logger="NO"</c> set in <path>/etc/rc.conf</path>, you
+will find information on the boot activity stored in that log file.
</impo>
<p>
1.20 xml/htdocs/doc/en/handbook/hb-net-wireless.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml?rev=1.20&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml?rev=1.20&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml?r1=1.19&r2=1.20
Index: hb-net-wireless.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- hb-net-wireless.xml 7 Nov 2010 20:16:49 -0000 1.19
+++ hb-net-wireless.xml 14 Aug 2011 16:12:13 -0000 1.20
@@ -4,7 +4,7 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v 1.19
2010/11/07 20:16:49 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v 1.20
2011/08/14 16:12:13 swift Exp $ -->
<sections>
@@ -12,8 +12,8 @@
Wireless configuration can be tricky. Hopefully we'll get you working!
</abstract>
-<version>9.1</version>
-<date>2010-11-07</date>
+<version>10</version>
+<date>2011-08-13</date>
<section>
<title>Introduction</title>
@@ -113,7 +113,7 @@
<pre caption="configure /etc/conf.d/net for wpa_supplicant">
<comment># Prefer wpa_supplicant over wireless-tools</comment>
-modules=( "wpa_supplicant" )
+modules="wpa_supplicant"
<comment># It's important that we tell wpa_supplicant which driver we should
# be using as it's not very good at guessing yet</comment>
@@ -259,7 +259,7 @@
<pre caption="sample iwconfig setup in /etc/conf.d/net">
<comment># Prefer iwconfig over wpa_supplicant</comment>
-modules=( "iwconfig" )
+modules="iwconfig"
<comment># Configure WEP keys for Access Points called ESSID1 and
ESSID2</comment>
<comment># You may configure up to 4 WEP keys, but only 1 can be active at
@@ -278,7 +278,7 @@
<comment># Sometimes more than one Access Point is visible so we need to
# define a preferred order to connect in</comment>
-preferred_aps=( "ESSID1" "ESSID2" )
+preferred_aps="'ESSID1' 'ESSID2'"
</pre>
</body>
@@ -340,7 +340,7 @@
<pre caption="blacklist_aps and unique_ap example">
<comment># Sometimes you never want to connect to certain access
points</comment>
-blacklist_aps=( "ESSID3" "ESSID4" )
+blacklist_aps="'ESSID3' 'ESSID4'"
<comment># If you have more than one wireless card, you can say if you want
# to allow each card to associate with the same Access Point or not
@@ -500,24 +500,24 @@
</impo>
<pre caption="override network settings per ESSID">
-config_ESSID1=( "192.168.0.3/24 brd 192.168.0.255" )
-routes_ESSID1=( "default via 192.168.0.1" )
+config_ESSID1="192.168.0.3/24 brd 192.168.0.255"
+routes_ESSID1="default via 192.168.0.1"
-config_ESSID2=( "dhcp" )
-fallback_ESSID2=( "192.168.3.4/24" )
-fallback_route_ESSID2=( "default via 192.168.3.1" )
+config_ESSID2="dhcp"
+fallback_ESSID2="192.168.3.4/24"
+fallback_route_ESSID2="default via 192.168.3.1"
<comment># We can define nameservers and other things too</comment>
<comment># NOTE: DHCP will override these unless it's told not too</comment>
-dns_servers_ESSID1=( "192.168.0.1" "192.168.0.2" )
+dns_servers_ESSID1="192.168.0.1 192.168.0.2"
dns_domain_ESSID1="some.domain"
dns_search_domains_ESSID1="search.this.domain search.that.domain"
<comment># You override by the MAC address of the Access Point
# This handy if you goto different locations that have the same ESSID</comment>
-config_001122334455=( "dhcp" )
+config_001122334455="dhcp"
dhcpcd_001122334455="-t 10"
-dns_servers_001122334455=( "192.168.0.1" "192.168.0.2" )
+dns_servers_001122334455="192.168.0.1 192.168.0.2"
</pre>
</body>
1.34 xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml?rev=1.34&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml?rev=1.34&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml?r1=1.33&r2=1.34
Index: hb-working-rcscripts.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- hb-working-rcscripts.xml 12 Aug 2011 19:34:56 -0000 1.33
+++ hb-working-rcscripts.xml 14 Aug 2011 16:12:13 -0000 1.34
@@ -4,7 +4,7 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml,v 1.33
2011/08/12 19:34:56 swift Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml,v 1.34
2011/08/14 16:12:13 swift Exp $ -->
<sections>
@@ -778,21 +778,25 @@
<p>
Even though <c>net.eth0</c> has been removed from the offline runlevel,
-<c>udev</c> will still attempt to start any devices it detects and launch the
-appropriate services. Therefore, you will need to add each network service you
-do not want started (as well as services for any other devices that may be
-started by udev) to <path>/etc/conf.d/rc</path> as shown.
+<c>udev</c> might want to attempt to start any devices it detects and launch
the
+appropriate services, a functionality that is called <e>hotplugging</e>. By
+default, Gentoo does not enable hotplugging.
</p>
-<pre caption="Disabling device initiated services in /etc/conf.d/rc">
-RC_COLDPLUG="yes"
-<comment>(Next, specify the services you do not want automatically
started)</comment>
-RC_PLUG_SERVICES="!net.eth0"
+<p>
+If you do want to enable hotplugging, but only for a selected set of scripts,
+use the <c>rc_hotplug</c> variable in <path>/etc/rc.conf</path>:
+</p>
+
+<pre caption="Disabling device initiated services in /etc/rc.conf">
+<comment># Allow net.wlan as well as any other service, except those matching
net.*
+# to be hotplugged</comment>
+rc_hotplug="net.wlan !net.*"
</pre>
<note>
For more information on device initiated services, please see the comments
-inside <path>/etc/conf.d/rc</path>.
+inside <path>/etc/rc.conf</path>.
</note>
<p>
