source: chapter06/iproute2.xml@ 39ec01c

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 39ec01c was f3f4c64, checked in by Matthew Burgess <matthew@…>, 12 years ago

Upgrade to IPRoute2-3.3.0. Fixes #3043.

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

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