source: networking/netprogs/bridgeutils.xml@ 81076bb6

10.0 10.1 11.0 8.4 9.0 9.1 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 81076bb6 was 81076bb6, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags for networking and postscript.
Archive two unused files.

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

  • Property mode set to 100644
File size: 7.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY bridge-download-http "&kernel-dl;/linux/utils/net/bridge-utils/bridge-utils-&bridgeutils-version;.tar.xz">
8 <!ENTITY bridge-download-ftp " ">
9 <!ENTITY bridge-md5sum "541ae1c50cc268056693608920e6c908">
10 <!ENTITY bridge-size "32 KB">
11 <!ENTITY bridge-buildsize "916 KB">
12 <!ENTITY bridge-time "less than 0.1 SBU">
13]>
14
15<sect1 id="bridgeutils" xreflabel="bridge-utils-&bridgeutils-version;">
16 <?dbhtml filename="bridge-utils.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>bridge-utils-&bridgeutils-version;</title>
24
25 <indexterm zone="bridgeutils">
26 <primary sortas="a-bridgeutils">bridge-utils</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to bridge-utils</title>
31
32 <para>The <application>bridge-utils</application> package contains a utility
33 needed to create and manage bridge devices. This is useful in setting up
34 networks for a hosted virtual machine (VM).</para>
35
36 &lfs84_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&bridge-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&bridge-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &bridge-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &bridge-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &bridge-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &bridge-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">bridge-utils Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Optional (to run tests)</bridgehead>
63 <para role="optional">
64 <xref linkend="net-tools"/>
65 </para>
66
67 <para condition="html" role="usernotes">User Notes:
68 <ulink url="&blfs-wiki;/bridge"/></para>
69
70 </sect2>
71
72 <sect2 role="kernel" id='bridgeutils-kernel'>
73 <title>Kernel Configuration</title>
74
75 <para>Enable the following options in the kernel configuration
76 and recompile the kernel if necessary:</para>
77
78<screen><literal>[*] Networking support ---&gt; [CONFIG_NET]
79 Networking options ---&gt;
80 &lt;*/M&gt; 802.1d Ethernet Bridging [CONFIG_BRIDGE]</literal></screen>
81
82 <indexterm zone="bridgeutils bridgeutils-kernel">
83 <primary sortas="d-bridgeutils">Bridge Utilities</primary>
84 </indexterm>
85
86 </sect2>
87
88 <sect2 role="installation">
89 <title>Installation of bridge-utils</title>
90
91 <para>Install <application>bridge-utils</application> by running the following
92 commands:</para>
93
94<screen><userinput>autoconf &amp;&amp;
95./configure --prefix=/usr &amp;&amp;
96make</userinput></screen>
97
98 <para>Testing the results requires running the six shell scripts in
99 the <filename class='directory'>tools/</filename> directory.
100 Two of the tests require two ethernet ports. Some tests
101 will not preserve the current network configuration. See
102 <filename>tests/README</filename> for details.</para>
103
104 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
105
106<screen role="root"><userinput>make install</userinput></screen>
107
108 </sect2>
109
110 <sect2 role="configuration">
111 <title>Configuring bridge-utils</title>
112
113 <sect3 id='bridgeutils-init' revision="sysv">
114 <title>Configuration Information</title>
115
116 <para>To automate bridge creation and configuration,
117 install the <filename>/lib/services/etc/bridge</filename>
118 service script included in the <xref linkend="bootscripts"/>
119 package.</para>
120
121 <indexterm zone="bridgeutils bridgeutils-init">
122 <primary sortas="f-bridgeutils">bridge-utils</primary>
123 </indexterm>
124
125<screen role="root"><userinput>make install-service-bridge</userinput></screen>
126
127 <note><para>The <filename>bridge</filename> script depends
128 on the commands <command>/sbin/ifup</command> and
129 <command>/sbin/ifdown</command> and the service script
130 <emphasis>ipv4-static</emphasis> from the <emphasis>LFS</emphasis>
131 bootscripts dated January 27, 2012 or later.</para></note>
132
133 <para>The following configuration file will create a bridge device at
134 boot time and attach the eth0 device to it. If more than one device is
135 desired, use a space separated list of INTERFACE_COMPONENTS. This
136 configuration is useful when planning to run a virtual machine such as
137 kvm/qemu.</para>
138
139 <para>Other SERVICE combinations are possible, for example,
140 SERVICES="bridge dhcp". In that case, the address parameters
141 are not needed, but do not interfere if present. The
142 bridge service may also be used alone, but will require
143 additional subsequent configuration.</para>
144
145 <caution><para>Do not run a parallel configuration for a device in the
146 INTERFACE_COMPONENTS list. For instance, in the example below, do not
147 configure <filename>/etc/sysconfig/ifconfig.eth0</filename> to run at
148 boot time. The command <command>ifdown br0</command> followed by
149 command <command>ifup eth0</command> will work, but don't try to have
150 both up at the same time.</para></caution>
151
152<screen role="root"><userinput>cat &gt; /etc/sysconfig/ifconfig.br0 &lt;&lt; "EOF"
153<literal>ONBOOT=yes
154IFACE=br0
155SERVICE="bridge ipv4-static" # Space separated
156IP=192.168.1.32
157GATEWAY=192.168.1.1
158PREFIX=24
159BROADCAST=192.168.1.255
160CHECK_LINK=no # Don't check before bridge is created
161STP=no # Spanning tree protocol, default no
162INTERFACE_COMPONENTS="eth0" # Add to IFACE, space separated devices
163IP_FORWARD=true</literal>
164EOF</userinput></screen>
165
166 <para>All addresses should be changed to meet your circumstance.</para>
167
168 </sect3>
169
170 <sect3 id='bridgeutils-init-systemd' revision="systemd">
171 <title>Configuration Information</title>
172 <para>TBA</para>
173 </sect3>
174
175 </sect2>
176
177
178 <sect2 role="content">
179 <title>Contents</title>
180
181 <segmentedlist>
182 <segtitle>Installed Program</segtitle>
183 <segtitle>Installed Libraries</segtitle>
184 <segtitle>Installed Directories</segtitle>
185
186 <seglistitem>
187 <seg>brctl</seg>
188 <seg>None</seg>
189 <seg>None</seg>
190 </seglistitem>
191 </segmentedlist>
192
193 <variablelist>
194 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
195 <?dbfo list-presentation="list"?>
196 <?dbhtml list-presentation="table"?>
197
198 <varlistentry id="brctl">
199 <term><command>brctl</command></term>
200 <listitem>
201 <para>is a program used to set up, maintain, and inspect the
202 ethernet bridge configuration in the linux kernel. </para>
203 <indexterm zone="bridgeutils brctl">
204 <primary sortas="b-brctl">brctl</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 </variablelist>
210
211 </sect2>
212
213</sect1>
Note: See TracBrowser for help on using the repository browser.