source: chapter06/iproute2.xml@ a3af16f

7.5-systemd 7.6-systemd 7.7-systemd 7.8-systemd 7.9-systemd
Last change on this file since a3af16f was a3af16f, checked in by Matthew Burgess <matthew@…>, 11 years ago

Merge latest trunk updates to systemd branch

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/systemd/BOOK@10365 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 11.7 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
8<sect1 id="ch-system-iproute2" role="wrap">
9 <?dbhtml filename="iproute2.html"?>
10
11 <sect1info condition="script">
12 <productname>iproute2</productname>
13 <productnumber>&iproute2-version;</productnumber>
14 <address>&iproute2-url;</address>
15 </sect1info>
16
17 <title>IPRoute2-&iproute2-version;</title>
18
19 <indexterm zone="ch-system-iproute2">
20 <primary sortas="a-IPRoute2">IPRoute2</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The IPRoute2 package contains programs for basic and advanced IPV4-based
27 networking.</para>
28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
34 <seg>&iproute2-ch6-sbu;</seg>
35 <seg>&iproute2-ch6-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38
39 </sect2>
40
41 <sect2 role="installation">
42 <title>Installation of IPRoute2</title>
43
44 <para>The <command>arpd</command> binary included in this package is
45 dependent on Berkeley DB. Because <command>arpd</command> is not a very
46 common requirement on a base Linux system, remove the dependency on Berkeley
47 DB by applying the commands below. If the <command>arpd</command> binary is
48 needed, instructions for compiling Berkeley DB can be found in the BLFS Book
49 at <ulink url="&blfs-root;view/svn/server/databases.html#db"/>.
50 </para>
51
52<screen><userinput remap="pre">sed -i '/^TARGETS/s@arpd@@g' misc/Makefile
53sed -i /ARPD/d Makefile
54sed -i 's/arpd.8//' man/man8/Makefile</userinput></screen>
55
56<!-- Save as comments for now
57 <para>Remove a compiler flag that causes the compilation to fail:</para>
58<screen><userinput remap="pre">sed -i 's/-Werror//' Makefile</userinput></screen>
59-->
60
61 <para>Compile the package:</para>
62
63<screen><userinput remap="make">make DESTDIR=</userinput></screen>
64
65 <variablelist>
66 <title>The meaning of the make option:</title>
67
68 <varlistentry>
69 <term><parameter>DESTDIR=</parameter></term>
70 <listitem>
71 <para>This ensures that the IPRoute2 binaries will install into
72 the correct directory. By default, <parameter>DESTDIR</parameter> is
73 set to <filename class="directory">/usr</filename>.</para>
74 </listitem>
75 </varlistentry>
76
77 </variablelist>
78
79 <para>This package comes with a test suite, but due to assumptions it makes,
80 it is not possible to reliably run these tests from within the chroot
81 environment. If you wish to run these tests after booting into your new LFS
82 system, ensure you select <filename>/proc/config.gz</filename>
83 CONFIG_IKCONFIG_PROC (&quot;General setup&quot; -> &quot;Enable access to
84 .config through /proc/config.gz&quot;) support into your kernel then run
85 'make alltests' from the <filename class="directory">testsuite/</filename>
86 subdirectory.</para>
87
88 <para>Install the package:</para>
89
90<screen><userinput remap="install">make DESTDIR= \
91 MANDIR=/usr/share/man \
92 DOCDIR=/usr/share/doc/iproute2-&iproute2-version; install</userinput></screen>
93
94 </sect2>
95
96 <sect2 id="contents-iproute2" role="content">
97 <title>Contents of IPRoute2</title>
98
99 <segmentedlist>
100 <segtitle>Installed programs</segtitle>
101 <segtitle>Installed directories</segtitle>
102
103 <seglistitem>
104 <seg>bridge, ctstat (link to lnstat), genl, ifcfg, ifstat, ip, lnstat,
105 nstat, routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
106 and tc</seg>
107 <seg>/etc/iproute2, /lib/tc, /usr/share/doc/iproute2-&iproute2-version;,
108 /usr/lib/tc</seg>
109 </seglistitem>
110 </segmentedlist>
111
112 <variablelist>
113 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
114 <?dbfo list-presentation="list"?>
115 <?dbhtml list-presentation="table"?>
116
117 <varlistentry id="bridge">
118 <term><command>bridge</command></term>
119 <listitem>
120 <para>Configures network bridges</para>
121 <indexterm zone="ch-system-iproute2 bridge">
122 <primary sortas="b-bridge">bridge</primary>
123 </indexterm>
124 </listitem>
125 </varlistentry>
126
127 <varlistentry id="ctstat">
128 <term><command>ctstat</command></term>
129 <listitem>
130 <para>Connection status utility</para>
131 <indexterm zone="ch-system-iproute2 ctstat">
132 <primary sortas="b-ctstat">ctstat</primary>
133 </indexterm>
134 </listitem>
135 </varlistentry>
136
137 <varlistentry id="genl">
138 <term><command>genl</command></term>
139 <listitem>
140 <para></para>
141 <indexterm zone="ch-system-iproute2 genl">
142 <primary sortas="b-genl">genl</primary>
143 </indexterm>
144 </listitem>
145 </varlistentry>
146
147 <varlistentry id="ifcfg">
148 <term><command>ifcfg</command></term>
149 <listitem>
150 <para>A shell script wrapper for the <command>ip</command> command.
151 Note that it requires the <command>arping</command> and
152 <command>rdisk</command> programs from the
153 iputils package found at <ulink url="http://www.skbuff.net/iputils/"/>.</para>
154 <indexterm zone="ch-system-iproute2 ifcfg">
155 <primary sortas="b-ifcfg">ifcfg</primary>
156 </indexterm>
157 </listitem>
158 </varlistentry>
159
160 <varlistentry id="ifstat">
161 <term><command>ifstat</command></term>
162 <listitem>
163 <para>Shows the interface statistics, including the amount of
164 transmitted and received packets by interface</para>
165 <indexterm zone="ch-system-iproute2 ifstat">
166 <primary sortas="b-ifstat">ifstat</primary>
167 </indexterm>
168 </listitem>
169 </varlistentry>
170
171 <varlistentry id="ip">
172 <term><command>ip</command></term>
173 <listitem>
174 <para>The main executable. It has several different functions:</para>
175
176 <para><command>ip link <replaceable>&lt;device&gt;</replaceable></command>
177 allows users to look at the state of devices and to make changes</para>
178
179 <para><command>ip addr</command> allows users to look at addresses and
180 their properties, add new addresses, and delete old ones</para>
181
182 <para><command>ip neighbor</command> allows users to look at neighbor
183 bindings and their properties, add new neighbor entries, and delete
184 old ones</para>
185
186 <para><command>ip rule</command> allows users to look at the routing
187 policies and change them</para>
188
189 <para><command>ip route</command> allows users to look at the routing
190 table and change routing table rules</para>
191
192 <para><command>ip tunnel</command> allows users to look at the IP
193 tunnels and their properties, and change them</para>
194
195 <para><command>ip maddr</command> allows users to look at the multicast
196 addresses and their properties, and change them</para>
197
198 <para><command>ip mroute</command> allows users to set, change, or
199 delete the multicast routing</para>
200
201 <para><command>ip monitor</command> allows users to continuously monitor
202 the state of devices, addresses and routes</para>
203 <indexterm zone="ch-system-iproute2 ip">
204 <primary sortas="b-ip">ip</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="lnstat">
210 <term><command>lnstat</command></term>
211 <listitem>
212 <para>Provides Linux network statistics. It is a generalized and more
213 feature-complete replacement for the old <command>rtstat</command>
214 program</para>
215 <indexterm zone="ch-system-iproute2 lnstat">
216 <primary sortas="b-lnstat">lnstat</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="nstat">
222 <term><command>nstat</command></term>
223 <listitem>
224 <para>Shows network statistics</para>
225 <indexterm zone="ch-system-iproute2 nstat">
226 <primary sortas="b-nstat">nstat</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="routef">
232 <term><command>routef</command></term>
233 <listitem>
234 <para>A component of <command>ip route</command>. This is for flushing
235 the routing tables</para>
236 <indexterm zone="ch-system-iproute2 routef">
237 <primary sortas="b-routef">routef</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="routel">
243 <term><command>routel</command></term>
244 <listitem>
245 <para>A component of <command>ip route</command>. This is for listing
246 the routing tables</para>
247 <indexterm zone="ch-system-iproute2 routel">
248 <primary sortas="b-routel">routel</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="rtacct">
254 <term><command>rtacct</command></term>
255 <listitem>
256 <para>Displays the contents of
257 <filename>/proc/net/rt_acct</filename></para>
258 <indexterm zone="ch-system-iproute2 rtacct">
259 <primary sortas="b-rtacct">rtacct</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="rtmon">
265 <term><command>rtmon</command></term>
266 <listitem>
267 <para>Route monitoring utility</para>
268 <indexterm zone="ch-system-iproute2 rtmon">
269 <primary sortas="b-rtmon">rtmon</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="rtpr">
275 <term><command>rtpr</command></term>
276 <listitem>
277 <para>Converts the output of <command>ip -o</command> back into a
278 readable form</para>
279 <indexterm zone="ch-system-iproute2 rtpr">
280 <primary sortas="b-rtpr">rtpr</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="rtstat">
286 <term><command>rtstat</command></term>
287 <listitem>
288 <para>Route status utility</para>
289 <indexterm zone="ch-system-iproute2 rtstat">
290 <primary sortas="b-rtstat">rtstat</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="ss">
296 <term><command>ss</command></term>
297 <listitem>
298 <para>Similar to the <command>netstat</command> command; shows active
299 connections</para>
300 <indexterm zone="ch-system-iproute2 ss">
301 <primary sortas="b-ss">ss</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="tc">
307 <term><command>tc</command></term>
308 <listitem>
309 <para>Traffic Controlling Executable; this is for Quality Of Service
310 (QOS) and Class Of Service (COS) implementations</para>
311
312 <para><command>tc qdisc</command> allows users to setup the queueing
313 discipline</para>
314
315 <para><command>tc class</command> allows users to setup classes based
316 on the queuing discipline scheduling</para>
317
318 <para><command>tc estimator</command> allows users to estimate the
319 network flow into a network</para>
320
321 <para><command>tc filter</command> allows users to setup the QOS/COS
322 packet filtering</para>
323
324 <para><command>tc policy</command> allows users to setup the QOS/COS
325 policies</para>
326 <indexterm zone="ch-system-iproute2 ss">
327 <primary sortas="b-tc">tc</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 </variablelist>
333
334 </sect2>
335
336</sect1>
Note: See TracBrowser for help on using the repository browser.