[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-net-advanced.xml

[Sven Vermeulen (swift)]

swift       11/08/17 08:05:11

  Modified:             hb-net-advanced.xml
  Log:
  Part of bug #337140 - Tell users that "provide net" needs to be influenced when you are dealing with stuff like bridges. Also fixes another OpenRC issue

Revision  Changes    Path
1.17                 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.17&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?rev=1.17&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?r1=1.16&r2=1.17

Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- hb-net-advanced.xml	14 Aug 2011 16:12:13 -0000	1.16
+++ hb-net-advanced.xml	17 Aug 2011 08:05:11 -0000	1.17
@@ -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.16 2011/08/14 16:12:13 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.17 2011/08/17 08:05:11 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 before we learn about modular networking.
 </abstract>
 
-<version>9</version>
-<date>2011-08-13</date>
+<version>10</version>
+<date>2011-08-17</date>
 
 <section>
 <title>Advanced Configuration</title>
@@ -75,29 +75,23 @@
 
 <pre caption="Configuration examples">
 <comment># Adding three IPv4 addresses</comment>
-config_eth0=(
-  "192.168.0.2/24"
-  "192.168.0.3/24"
-  "192.168.0.4/24"
-)
+config_eth0="192.168.0.2/24
+192.168.0.3/24
+192.168.0.4/24"
 
 <comment># Adding an IPv4 address and two IPv6 addresses</comment>
-config_eth0=(
-  "192.168.0.2/24"
-  "4321:0:1:2:3:4:567:89ab"
-  "4321:0:1:2:3:4:567:89ac"
+config_eth0="192.168.0.2/24
+4321:0:1:2:3:4:567:89ab
+4321:0:1:2:3:4:567:89ac"
 )
 
 <comment># Keep our kernel assigned address, unless the interface goes
 # down so assign another via DHCP. If DHCP fails then add a
 # static address determined by APIPA</comment>
-config_eth0=(
-  "noop"
-  "dhcp"
-)
-fallback_eth0=(
-  "null"
-  "apipa"
+config_eth0="noop
+dhcp"
+fallback_eth0="null
+apipa"
 )
 </pre>
 
@@ -164,6 +158,20 @@
 </pre>
 
 <p>
+That alone, however, is not sufficient. Gentoo's networking init scripts use a
+virtual dependency called <e>net</e> to inform the system when networking is
+available. Clearly, in the above case, networking should only be marked as
+available when <path>net.br0</path> is up, not when the others are. So we need
+to tell that in <path>/etc/conf.d/net</path> as well:
+</p>
+
+<pre caption="Updating virtual dependencies and provisions for networking">
+rc_net_lo_provide="!net"
+rc_net_eth0_provide="!net"
+rc_net_eth1_provide="!net"
+</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. More information about <path>/etc/rc.conf</path> is available as