source: chapter06/iproute2.xml@ 55fa5a3

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 6.5 6.6 6.7 6.8 7.0 7.1 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 55fa5a3 was aa909a0, checked in by Matthew Burgess <matthew@…>, 15 years ago

Remove redundant SBINDIR parameter from IPRoute2's instructions. Fixes last part of #2307.

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

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