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

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

[Sven Vermeulen (swift)]

swift       11/10/23 09:46:14

  Modified:             hb-net-modules.xml
  Log:
  Bug #387697 - OpenRC prefers iproute2 over ifconfig by default. Thanks to Grant Edwards for reporting

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

Index: hb-net-modules.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- hb-net-modules.xml	14 Aug 2011 16:12:13 -0000	1.26
+++ hb-net-modules.xml	23 Oct 2011 09:46:14 -0000	1.27
@@ -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.26 2011/08/14 16:12:13 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.27 2011/10/23 09:46:14 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 different DHCP clients, setting up bonding, bridging, VLANs and more.
 </abstract>
 
-<version>9</version>
-<date>2011-08-13</date>
+<version>10</version>
+<date>2011-10-23</date>
 
 <section>
 <title>Network Modules</title>
@@ -40,8 +40,8 @@
 </note>
 
 <pre caption="Module preference">
-<comment># Prefer iproute2 over ifconfig</comment>
-modules="iproute2"
+<comment># Prefer ifconfig over iproute2</comment>
+modules="ifconfig"
 
 <comment># You can also specify other modules for an interface
 # In this case we prefer pump over dhcpcd</comment>
@@ -65,16 +65,17 @@
 </p>
 
 <p>
-<c>ifconfig</c> is the current Gentoo default and it's included in the system
-profile. <c>iproute2</c> is a more powerful and flexible package, but it's not
-included by default.
+<c>ifconfig</c> is installed by default (the <c>net-tools</c> package is part of
+the system profile). <c>iproute2</c> is a more powerful and flexible package,
+but it's not included by default.
 </p>
 
 <pre caption="To install iproute2">
 # <i>emerge sys-apps/iproute2</i>
 
-<comment># To prefer iproute2 over ifconfig if both are installed</comment>
-modules="iproute2"
+<comment># To prefer ifconfig over iproute2 if both are installed as openrc prefers
+# to use iproute2 then</comment>
+modules="ifconfig"
 </pre>
 
 <p>

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

[Sven Vermeulen (swift)]

swift       13/08/15 08:30:19

  Modified:             hb-net-modules.xml
  Log:
  Fix bug #400721 - Fix bonding instructions

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

Index: hb-net-modules.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- hb-net-modules.xml	23 Oct 2011 09:46:14 -0000	1.27
+++ hb-net-modules.xml	15 Aug 2013 08:30:19 -0000	1.28
@@ -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.27 2011/10/23 09:46:14 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.28 2013/08/15 08:30:19 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 different DHCP clients, setting up bonding, bridging, VLANs and more.
 </abstract>
 
-<version>10</version>
-<date>2011-10-23</date>
+<version>11</version>
+<date>2013-08-15</date>
 
 <section>
 <title>Network Modules</title>
@@ -312,17 +312,30 @@
 just one interface but they really use both network cards.
 </p>
 
-<pre caption="bonding configuration in /etc/conf.d/net">
-<comment># To bond interfaces together</comment>
-slaves_bond0="eth0 eth1 eth2"
+<p>
+First, clear the configuration of the participating interfaces:
+</p>
 
-<comment># You may not want to assign an IP to the bonded interface</comment>
-config_bond0="null"
+<pre caption="Clearing interface configuration in /etc/conf.d/net">
+config_eth0="null"
+config_eth1="null"
+config_eth2="null"
+</pre>
 
-<comment># Depend on eth0, eth1 and eth2 as they may require extra configuration</comment>
-rc_need_bond0="net.eth0 net.eth1 net.eth2"
+<p>
+Next, define the bonding between the interfaces:
+</p>
+
+<pre caption="Define the bonding">
+slaves_bond0="eth0 eth1 eth2"
+config_bond0="192.168.100.4/24"
 </pre>
 
+<p>
+Remove the <path>net.eth*</path> services from the runlevels, create a
+<path>net.bond0</path> one and add that one to the correct runlevel.
+</p>
+
 </body>
 </section>
 <section>
@@ -423,7 +436,8 @@
 <body>
 
 <p>
-For VLAN support, emerge <c>net-misc/vconfig</c>.
+For VLAN support, emerge <c>net-misc/vconfig</c>. Also make sure that you use
+iproute2 as configuration module rather than ifconfig.
 </p>
 
 <p>
@@ -433,19 +447,35 @@
 network.
 </p>
 
-<pre caption="VLAN configuration in /etc/conf.d/net">
-<comment># Specify the VLAN numbers for the interface like so</comment>
-<comment># Please ensure your VLAN IDs are NOT zero-padded</comment>
+<p>
+To configure VLANs, first specify the VLAN numbers in
+<path>/etc/conf.d/net</path> like so:
+</p>
+
+<pre caption="Specifying VLAN numbers">
 vlans_eth0="1 2"
+</pre>
+
+<p>
+Next, configure the interface for each VLAN:
+</p>
+
+<pre caption="Interface configuration for each VLAN">
+config_eth0_1="172.16.3.1 netmask 255.255.254.0"
+routes_eth0_1="default via 172.16.3.254"
+
+config_eth0_2="172.16.2.1 netmask 255.255.254.0"
+routes_eth0_2="default via 172.16.2.254"
+</pre>
+
+<p>
+VLAN-specific configurations are handled by <c>vconfig</c> like so:
+</p>
 
-<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"
-
-<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"
+<pre caption="Configuring the VLANs">
+vlan1_name="vlan1"
+vlan1_ingress="2:6 3:5"
+eth0_vlan1_egress="1:2"
 </pre>
 
 <impo>

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

[Sven Vermeulen (swift)]

swift       13/12/17 09:00:42

  Modified:             hb-net-modules.xml
  Log:
  Fix bug #445346 - Fix bridge example

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

Index: hb-net-modules.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- hb-net-modules.xml	15 Aug 2013 08:30:19 -0000	1.28
+++ hb-net-modules.xml	17 Dec 2013 09:00:41 -0000	1.29
@@ -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.28 2013/08/15 08:30:19 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.29 2013/12/17 09:00:41 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 different DHCP clients, setting up bonding, bridging, VLANs and more.
 </abstract>
 
-<version>11</version>
-<date>2013-08-15</date>
+<version>12</version>
+<date>2013-12-17</date>
 
 <section>
 <title>Network Modules</title>
@@ -355,7 +355,9 @@
 
 <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 2
+stp on"
 
 <comment># To add ports to bridge br0</comment>
 bridge_br0="eth0 eth1"

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

[Sven Vermeulen (swift)]

swift       14/04/12 06:24:48

  Modified:             hb-net-modules.xml
  Log:
  Fix bug #501782 - VLAN support is handled by iproute2 nowadays, thanks to Brian Evans

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

Index: hb-net-modules.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- hb-net-modules.xml	17 Dec 2013 11:48:58 -0000	1.30
+++ hb-net-modules.xml	12 Apr 2014 06:24:48 -0000	1.31
@@ -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.30 2013/12/17 11:48:58 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.31 2014/04/12 06:24:48 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 different DHCP clients, setting up bonding, bridging, VLANs and more.
 </abstract>
 
-<version>13</version>
-<date>2013-12-17</date>
+<version>14</version>
+<date>2014-04-12</date>
 
 <section>
 <title>Network Modules</title>
@@ -437,8 +437,8 @@
 <body>
 
 <p>
-For VLAN support, emerge <c>net-misc/vconfig</c>. Also make sure that you use
-iproute2 as configuration module rather than ifconfig.
+For VLAN support, make sure that <c>sys-apps/iproute2</c> is installed and ensure
+that iproute2 is used as configuration module rather than ifconfig.
 </p>
 
 <p>

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

[Jan Kundrat (jkt)]

jkt         14/09/25 08:21:34

  Modified:             hb-net-modules.xml
  Log:
  Add an example on how to configure bonding, and clarify what it actually is
  
  Thanks to prometheanfire for reminding us on IRC.

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

Index: hb-net-modules.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- hb-net-modules.xml	12 Apr 2014 06:24:48 -0000	1.31
+++ hb-net-modules.xml	25 Sep 2014 08:21:34 -0000	1.32
@@ -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.31 2014/04/12 06:24:48 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.32 2014/09/25 08:21:34 jkt Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 different DHCP clients, setting up bonding, bridging, VLANs and more.
 </abstract>
 
-<version>14</version>
-<date>2014-04-12</date>
+<version>15</version>
+<date>2014-09-25</date>
 
 <section>
 <title>Network Modules</title>
@@ -306,9 +306,17 @@
 </p>
 
 <p>
-Bonding is used to increase network bandwidth. If you have two network cards
-going to the same network, you can bond them together so your applications see
-just one interface but they really use both network cards.
+Bonding is used to increase network bandwidth or to improve resiliency in face
+of hardware failures. If you have two network cards going to the same network,
+you can bond them together so your applications see just one interface but they
+really use both network cards.
+</p>
+
+<p>
+There are many ways to configure bonding. Some of them, such as the 802.3ad LACP
+mode, require support and additional configuration of the network switch. For a
+reference of the individual options, please refer to your copy of
+<path>/usr/src/linux/Documentation/networking/bonding.txt</path>.
 </p>
 
 <p>
@@ -328,6 +336,8 @@
 <pre caption="Define the bonding">
 slaves_bond0="eth0 eth1 eth2"
 config_bond0="192.168.100.4/24"
+<comment># Pick a correct mode and additional configuration options which suit your needs</comment>
+mode_bond0="balance-alb"
 </pre>
 
 <p>