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

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

[Sven Vermeulen (swift)]

swift       14/04/12 12:08:59

  Modified:             hb-net-advanced.xml
  Log:
  Fix bug #502986 - Document the net.ifnames only as recent udevs will no longer use 80-net-name-slot.rules whereas the kernel parameter remains supported

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

Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- hb-net-advanced.xml	23 Jun 2013 17:00:05 -0000	1.22
+++ hb-net-advanced.xml	12 Apr 2014 12:08:58 -0000	1.23
@@ -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.22 2013/06/23 17:00:05 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.23 2014/04/12 12:08:58 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 before we learn about modular networking.
 </abstract>
 
-<version>15</version>
-<date>2013-06-23</date>
+<version>16</version>
+<date>2014-04-12</date>
 
 <section>
 <title>Advanced Configuration</title>
@@ -305,18 +305,6 @@
 <c>net.ifnames=0</c> boot option in the boot loader.
 </p>
 
-<p>
-Another way of disabling this behavior (and thus reverting back to the
-kernel-provided naming) is to create an empty udev rule named
-<path>80-net-name-slot.rules</path> which will then override the default
-provided one (with the same name) that is responsible for taking care of network
-interface naming.
-</p>
-
-<pre caption="Overriding the network naming scheme">
-# <i>ln -s /dev/null /etc/udev/rules.d/80-net-name-slot.rules</i>
-</pre>
-
 </body>
 </subsection>
 <subsection>

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

[Sven Vermeulen (swift)]

swift       14/08/17 16:53:27

  Modified:             hb-net-advanced.xml
  Log:
  Fix bug #518682, improve network naming, thanks to Samuli Suominen

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

Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- hb-net-advanced.xml	12 Apr 2014 12:08:58 -0000	1.23
+++ hb-net-advanced.xml	17 Aug 2014 16:53:27 -0000	1.24
@@ -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.23 2014/04/12 12:08:58 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.24 2014/08/17 16:53:27 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 before we learn about modular networking.
 </abstract>
 
-<version>16</version>
-<date>2014-04-12</date>
+<version>17</version>
+<date>2014-08-17</date>
 
 <section>
 <title>Advanced Configuration</title>
@@ -331,10 +331,13 @@
 ID_NET_NAME_MAC=enxc80aa9429d76
 ID_OUI_FROM_DATABASE=Quanta Computer Inc.
 
+# <i>vim /etc/udev/rules.d/70-net-name-use-custom.rules</i>
+<comment># First one uses MAC information, and 70- number to be before other net rules</comment>
+SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="c8:0a:a9:42:9d:76", NAME="lan0"
+
 # <i>vim /etc/udev/rules.d/76-net-name-use-custom.rules</i>
-<comment># First one uses MAC information</comment>
-SUBSYSTEM=="net", ACTION=="add", ENV{ID_NET_NAME_MAC}=="enxc80aa9429d76", NAME="lan0"
-<comment># Second one uses ID_NET_NAME_PATH information</comment>
+<comment># Second one uses ID_NET_NAME_PATH information, and 76- number to be between</comment>
+<comment># 75-net-*.rules and 80-net-*.rules</comment>
 SUBSYSTEM=="net", ACTION=="add", ENV{ID_NET_NAME_PATH}=="enp3s0", NAME="wifi0"
 </pre>
 

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

[Sven Vermeulen (swift)]

swift       13/06/23 17:00:05

  Modified:             hb-net-advanced.xml
  Log:
  Fix bug 470674 - Fix typo and improve parameter declaration thanks to Vladimir

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

Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- hb-net-advanced.xml	11 May 2013 10:56:22 -0000	1.21
+++ hb-net-advanced.xml	23 Jun 2013 17:00:05 -0000	1.22
@@ -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.21 2013/05/11 10:56:22 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.22 2013/06/23 17:00:05 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 before we learn about modular networking.
 </abstract>
 
-<version>14</version>
-<date>2013-05-11</date>
+<version>15</version>
+<date>2013-06-23</date>
 
 <section>
 <title>Advanced Configuration</title>
@@ -237,7 +237,7 @@
 
 <p>
 Network interface names are not chosen arbitrarily: the Linux kernel and the
-device manager (most sytems have udev as their device manager although others
+device manager (most systems have udev as their device manager although others
 are available as well) choose the interface name through a fixed set of rules.
 </p>
 
@@ -267,7 +267,8 @@
 
 <p>
 Based on this information, the device manager decides how to name the interface
-on the system. By default, it uses the first hit of the above three parameters.
+on the system. By default, it uses the first hit of the first three parameters
+above (<c>ID_NET_NAME_ONBOARD</c>, <c>_SLOT</c> or <c>_PATH</c>).
 For instance, if <c>ID_NET_NAME_ONBOARD</c> is found and set to <c>eno1</c>, then
 the interface will be called eno1.
 </p>

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

[Sven Vermeulen (swift)]

swift       13/05/11 10:56:22

  Modified:             hb-net-advanced.xml
  Log:
  Fix bug #469090 - Correct numbering in file as rule needs to be between 76 and 79

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

Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- hb-net-advanced.xml	8 May 2013 06:28:15 -0000	1.20
+++ hb-net-advanced.xml	11 May 2013 10:56:22 -0000	1.21
@@ -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.20 2013/05/08 06:28:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.21 2013/05/11 10:56:22 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 before we learn about modular networking.
 </abstract>
 
-<version>13</version>
-<date>2013-05-07</date>
+<version>14</version>
+<date>2013-05-11</date>
 
 <section>
 <title>Advanced Configuration</title>
@@ -342,7 +342,7 @@
 ID_NET_NAME_MAC=enxc80aa9429d76
 ID_OUI_FROM_DATABASE=Quanta Computer Inc.
 
-# <i>vim /etc/udev/rules.d/70-net-name-use-custom.rules</i>
+# <i>vim /etc/udev/rules.d/76-net-name-use-custom.rules</i>
 <comment># First one uses MAC information</comment>
 SUBSYSTEM=="net", ACTION=="add", ENV{ID_NET_NAME_MAC}=="enxc80aa9429d76", NAME="lan0"
 <comment># Second one uses ID_NET_NAME_PATH information</comment>
@@ -352,7 +352,9 @@
 <p>
 Because the rules are triggered before the default one (rules are triggered in
 alphanumerical order, so 70 comes before 80) the names provided in the rule file
-will be used instead of the default ones.
+will be used instead of the default ones. The number granted to the file should
+be between 76 and 79 (the environment variables are defined by a rule start
+starts with 75 and the fallback naming is done in a rule numbered 80).
 </p>
 
 </body>

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

[Sven Vermeulen (swift)]

swift       13/05/08 06:28:15

  Modified:             hb-net-advanced.xml
  Log:
  Fix bug #468992 - Typo for ID_NET_NAME_ONBOARD parameter

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

Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- hb-net-advanced.xml	6 May 2013 14:24:20 -0000	1.19
+++ hb-net-advanced.xml	8 May 2013 06:28:15 -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-advanced.xml,v 1.19 2013/05/06 14:24:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.20 2013/05/08 06:28:15 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 before we learn about modular networking.
 </abstract>
 
-<version>12</version>
-<date>2013-05-06</date>
+<version>13</version>
+<date>2013-05-07</date>
 
 <section>
 <title>Advanced Configuration</title>
@@ -249,7 +249,7 @@
 <ol>
   <li>
     the onboard (on the interface itself) registered name of the network card,
-    which is later seen through the <c>ID_NET_NAME_ONBARD</c> parameter;
+    which is later seen through the <c>ID_NET_NAME_ONBOARD</c> parameter;
   </li>
   <li>
     the slot in which the network card is plugged in, which is later seen
@@ -268,7 +268,7 @@
 <p>
 Based on this information, the device manager decides how to name the interface
 on the system. By default, it uses the first hit of the above three parameters.
-For instance, if <c>ID_NET_NAME_ONBARD</c> is found and set to <c>eno1</c>, then
+For instance, if <c>ID_NET_NAME_ONBOARD</c> is found and set to <c>eno1</c>, then
 the interface will be called eno1.
 </p>
 

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

[Sven Vermeulen (swift)]

swift       11/08/19 16:07:30

  Modified:             hb-net-advanced.xml
  Log:
  Remove trailing ) from code listings, thanks to nimiux for spotting them

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

Index: hb-net-advanced.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- hb-net-advanced.xml	17 Aug 2011 08:05:11 -0000	1.17
+++ hb-net-advanced.xml	19 Aug 2011 16:07:30 -0000	1.18
@@ -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.17 2011/08/17 08:05:11 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.18 2011/08/19 16:07:30 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 before we learn about modular networking.
 </abstract>
 
-<version>10</version>
-<date>2011-08-17</date>
+<version>11</version>
+<date>2011-08-19</date>
 
 <section>
 <title>Advanced Configuration</title>
@@ -83,7 +83,6 @@
 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
@@ -92,7 +91,6 @@
 dhcp"
 fallback_eth0="null
 apipa"
-)
 </pre>
 
 <note>

[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