Changeset a23aa7b for networking/netprogs/bridgeutils.xml

Timestamp:

01/27/2012 08:31:11 PM (12 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

a1c3701

Parents:

37f746a8

Message:

Add configuration to bridge-utils and add bridge service script.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9244 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• networking/netprogs/bridgeutils.xml (modified) (2 diffs)

networking/netprogs/bridgeutils.xml

@@ -70 +70 @@
   </sect2>
 
+  <sect2 role="kernel" id='bridgeutils-kernel'>
+    <title>Kernel Configuration</title>
+
+    <para>Enable the following options in the kernel configuration
+    and recompile the kernel if necessary:</para>
+
+<screen><literal>Networking support: Y
+  Networking options: 
+    802.1d Ethernet Bridging: M or Y</literal></screen>
+
+    <indexterm zone="bridgeutils bridgeutils-kernel">
+      <primary sortas="d-bridgeutils">Bridge Utilities</primary>
+    </indexterm>
+
+  </sect2>
+
   <sect2 role="installation">
-    <title>Installation of Wget</title>
-
-    <para>Install <application>Wget</application> by running the following
+    <title>Installation of bridge-utils</title>
+
+    <para>Install <application>bridge-utils</application> by running the following
     commands:</para>
 
@@ -91 +107 @@
 
   </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring bridge-utils</title>
+
+    <sect3 id='bridgeutils-init'>
+      <title>Configuration Information</title>
+
+      <para>To automate bridge creation and configuration, 
+      install the <filename>/lib/services/etc/bridge</filename>
+      service script included in the <xref linkend="bootscripts"/>
+      package.</para>
+
+      <indexterm zone="bridgeutils bridgeutils-init">
+        <primary sortas="f-bridgeutils">bridge-utils</primary>
+      </indexterm>
+
+<screen role="root"><userinput>make install-bridge</userinput></screen>
+
+      <note><para>The <filename>bridge</filename> script depends
+      on the comamnds <command>/sbin/ifup</command> and 
+      <command>/sbin/ifdown</command> and the service script
+      <emphasis>ipv4-static</emphasis> from the <emphasis>LFS</emphasis>
+      bootscripts dated January 27, 2012 or later.</para></note>
+
+      <para>The following configuration file will create a bridge device
+      at boot time and attach the eth0 device to it.  If more than one
+      device is desired, use a space separated list of INTERFACES.  This
+      configuration is useful when planning to run a virtual machine
+      such as kvm/qemu.</para>
+
+      <para>Other SERVICE combinations are possible, for example, 
+      SERVICES="bridge dhcp".  In that case, the address parameters
+      are not needed, but do not interfere if present. The 
+      bridge service may also be used alone, but will require
+      additional subsequent configuration.</para>
+
+      <caution><para>Do not run a parallel configuration for a device
+      in the INTERFACES list.  For instance, in the example below,
+      do not configure <filename>/etc/sysconfig/ifconfig.eth0</filename>
+      to run at boot time.  The command <command>ifdown br0</command>
+      followed by  command <command>ifup eth0</command> will work, but
+      don't try to have both up at the same time.</para></caution>
+      
+<screen role="root"><userinput>cat &gt; /etc/sysconfig/ifconfig.br0 &lt;&lt; "EOF"
+<literal>ONBOOT=yes
+IFACE=br0
+SERVICE="bridge ipv4-static"  # Space separated
+IP=192.168.1.32
+GATEWAY=192.168.1.1
+PREFIX=24
+BROADCAST=192.168.1.255
+CHECK_LINK=no                 # Don't check before ibridge is created
+STP=no                        # Spanning tree protocol, default no
+INTERFACES="eth0"             # Add to IFACE, space separated devices 
+IP_FORWARD=true</literal>
+EOF</userinput></screen>
+
+      <para>All addresses should be changed to meet your circumstance.</para>
+
+    </sect3>
+
+  </sect2>
+
 
   <sect2 role="content">