Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc-cvs
Navigation:
Lists: gentoo-doc-cvs: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc-cvs@g.o
From: "Sven Vermeulen (swift)" <swift@g.o>
Subject: gentoo commit in xml/htdocs/doc/en/handbook: hb-net-advanced.xml hb-net-modules.xml hb-net-start.xml hb-net-wireless.xml hb-working-rcscripts.xml
Date: Sun, 14 Aug 2011 16:12:14 +0000 (UTC)
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&amp;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>





Navigation:
Lists: gentoo-doc-cvs: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
gentoo commit in xml/htdocs/doc/en: postgres-howto.xml
Next by thread:
gentoo commit in xml/htdocs/doc/en: sudo-guide.xml
Previous by date:
gentoo commit in xml/htdocs/doc/en: gnome-config.xml
Next by date:
gentoo commit in xml/htdocs/doc/en: gentoolkit.xml


Updated Jun 30, 2012

Summary: Archive of the gentoo-doc-cvs mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.