source: networking/netprogs/bridgeutils.xml@ 22c3cdd7

10.0 10.1 11.0 11.1 11.2 9.0 9.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 22c3cdd7 was 22c3cdd7, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tag remaining netwroking paclages

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22035 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 &lfs90_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
155VIRTINT=yes
156SERVICE="bridge ipv4-static" # Space separated
157IP=192.168.1.32
158GATEWAY=192.168.1.1
159PREFIX=24
160BROADCAST=192.168.1.255
161CHECK_LINK=no # Don't check before bridge is created
162STP=no # Spanning tree protocol, default no
163INTERFACE_COMPONENTS="eth0" # Add to IFACE, space separated devices
164IP_FORWARD=true</literal>
165EOF</userinput></screen>
166
167 <para>All addresses should be changed to meet your circumstance.</para>
168
169 </sect3>
170
171 <sect3 id='bridgeutils-init-systemd' revision="systemd">
172 <title>Configuration Information</title>
173 <para>TBA</para>
174 </sect3>
175
176 </sect2>
177
178
179 <sect2 role="content">
180 <title>Contents</title>
181
182 <segmentedlist>
183 <segtitle>Installed Program</segtitle>
184 <segtitle>Installed Libraries</segtitle>
185 <segtitle>Installed Directories</segtitle>
186
187 <seglistitem>
188 <seg>brctl</seg>
189 <seg>None</seg>
190 <seg>None</seg>
191 </seglistitem>
192 </segmentedlist>
193
194 <variablelist>
195 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
196 <?dbfo list-presentation="list"?>
197 <?dbhtml list-presentation="table"?>
198
199 <varlistentry id="brctl">
200 <term><command>brctl</command></term>
201 <listitem>
202 <para>is a program used to set up, maintain, and inspect the
203 ethernet bridge configuration in the linux kernel. </para>
204 <indexterm zone="bridgeutils brctl">
205 <primary sortas="b-brctl">brctl</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 </variablelist>
211
212 </sect2>
213
214</sect1>
Note: See TracBrowser for help on using the repository browser.