[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>