source: chapter06/iproute2.xml@ 1540ea0

Last change on this file since 1540ea0 was 186416d, checked in by Jim Gifford <jim@…>, 19 years ago

Updated IPRoute2

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/multi-arch/BOOK@4749 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 10.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
3 <!ENTITY % general-entities SYSTEM "../general.ent">
4 %general-entities;
5]>
6<sect1 id="ch-system-iproute2" role="wrap">
7 <title>Iproute2-&iproute2-version;</title>
8<?dbhtml filename="iproute2.html"?>
9 <indexterm zone="ch-system-iproute2">
10 <primary sortas="a-iproute2">Iproute2</primary>
11 </indexterm>
12 <sect2 role="package">
13 <title/>
14 <para>The Iproute2 package contains programs for basic and advanced
15 IPV4-based networking.
16 </para>
17 <segmentedlist>
18 <segtitle>&buildtime;</segtitle>
19 <segtitle>&diskspace;</segtitle>
20 <seglistitem>
21 <seg>0.1 SBU</seg>
22 <seg>3.4 MB</seg>
23 </seglistitem>
24 </segmentedlist>
25 <segmentedlist>
26 <segtitle>&dependencies;</segtitle>
27 <seglistitem>
28 <seg>GCC, Glibc, Make, Linux-Headers, and Sed</seg>
29 </seglistitem>
30 </segmentedlist>
31 </sect2>
32 <sect2 role="installation">
33 <title>Installation of Iproute2</title>
34 <para>The <command>arpd</command> binary included in this package is
35 dependent on Berkeley DB. Because <command>arpd</command> is not a very
36 common requirement on a base Linux system, remove the dependency on
37 Berkeley DB by applying the patch using the command below. If
38 the <command>arpd</command> binary is needed, instructions for
39 compiling Berkeley DB can be found in the BLFS Book at <ulink
40 url="&blfs-root;view/svn/content/databases.html#db"/>.
41 </para>
42
43 <screen><userinput>patch -Np1 -i ../iproute2-&iproute2-patch-version;-remove_db-1.patch</userinput></screen>
44
45 <para>This patch fixes a error calling constant htons during the build of iproute2.</para>
46
47 <screen><userinput>patch -Np1 -i ../iproute2-&iproute2-patch-version;-htons_fix-1.patch</userinput></screen>
48
49 <para>Prepare Iproute2 for compilation:</para>
50 <screen><userinput>./configure </userinput></screen>
51
52 <para>Compile the package:</para>
53
54 <screen><userinput>make SBINDIR=/sbin</userinput></screen>
55
56 <para>The meaning of the make option:</para>
57
58 <variablelist>
59 <varlistentry>
60 <term><parameter>SBINDIR=/sbin</parameter></term>
61 <listitem><para>This makes sure that the Iproute2 binaries will install into
62 <filename class="directory">/sbin</filename>. This is the correct
63 location according to the FHS, because some of the Iproute2 binaries are used
64 in the bootscripts.</para>
65 </listitem>
66 </varlistentry>
67 </variablelist>
68
69 <para>Install the package:</para>
70
71 <screen><userinput>make SBINDIR=/sbin install</userinput></screen>
72
73 </sect2>
74
75 <sect2 id="contents-iproute2" role="content">
76 <title>Contents of Iproute2</title>
77 <segmentedlist>
78 <segtitle>Installed programs</segtitle>
79 <seglistitem>
80 <seg>ctstat (link to lnstat), ifcfg, ifstat, ip, lnstat, nstat, routef,
81 routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss, and tc.
82 </seg>
83 </seglistitem>
84 </segmentedlist>
85
86 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
87<?dbfo list-presentation="list"?>
88<?dbhtml list-presentation="table"?>
89 <varlistentry id="ctstat">
90 <term>
91 <command>ctstat</command>
92 </term>
93 <listitem>
94 <para>Connection status utility.</para>
95 <indexterm zone="ch-system-iproute2 ctstat">
96 <primary sortas="b-cstat">ctstat</primary>
97 </indexterm>
98 </listitem>
99 </varlistentry>
100
101 <varlistentry id="ifcfg">
102 <term>
103 <command>ifcfg</command>
104 </term>
105 <listitem>
106 <para>A shell script wrapper for the <command>ip</command> command.</para>
107 <indexterm zone="ch-system-iproute2 ifcfg">
108 <primary sortas="b-ifcfg">ifcfg</primary>
109 </indexterm>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry id="ifstat">
114 <term>
115 <command>ifstat</command>
116 </term>
117 <listitem>
118 <para>Shows the interfaces statistic, including the amount of transmitted
119 and received packages by interface.</para>
120 <indexterm zone="ch-system-iproute2 ifstat">
121 <primary sortas="b-ifstat">ifstat</primary>
122 </indexterm>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry id="ip">
127 <term>
128 <command>ip</command>
129 </term>
130 <listitem>
131
132 <para>The main executable. It has several different functions:</para>
133
134 <para><command>ip link <replaceable>[device]</replaceable></command>
135 allows users to look at the state of devices and to make changes.
136 </para>
137
138 <para><command>ip addr</command> allows users to look at addresses and
139 their properties, add new addresses, and delete old ones.
140 </para>
141
142 <para><command>ip neighbor</command> allows users to look at
143 neighbor bindings and their properties, add new
144 neighbor entries, and delete old ones.
145 </para>
146
147 <para><command>ip rule</command> allows users to look at the routing
148 policies and change them.
149 </para>
150
151 <para><command>ip route</command> allows users to look at the routing
152 table and change routing table rules.
153 </para>
154
155 <para><command>ip tunnel</command> allows users to look at the IP
156 tunnels and their properties, and change them.
157 </para>
158
159 <para><command>ip maddr</command> allows users to look at the multicast
160 addresses and their properties, and change them.
161 </para>
162
163 <para><command>ip mroute</command> allows users to set, change, or
164 delete the multicast routing.
165 </para>
166
167 <para><command>ip monitor</command> allows users to
168 continously monitor the state of devices, addresses and routes.
169 </para>
170 <indexterm zone="ch-system-iproute2 ip">
171 <primary sortas="b-ip">ip</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="lnstat">
177 <term>
178 <command>lnstat</command>
179 </term>
180 <listitem>
181 <para>Provides Linux network statistics. It is a generalized and more
182 feature-complete replacement for the old
183 <command>rtstat</command> program.</para>
184 <indexterm zone="ch-system-iproute2 lnstat">
185 <primary sortas="b-cstat">lnstat</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="nstat">
191 <term>
192 <command>nstat</command>
193 </term>
194 <listitem>
195 <para>Shows network statistics.</para>
196 <indexterm zone="ch-system-iproute2 nstat">
197 <primary sortas="b-nstat">nstat</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="routef">
203 <term>
204 <command>routef</command>
205 </term>
206 <listitem>
207 <para>A component of <command>ip route</command>. This is for flushing the routing
208 tables.
209 </para>
210 <indexterm zone="ch-system-iproute2 routef">
211 <primary sortas="b-routef">routef</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 <varlistentry id="routel">
217 <term>
218 <command>routel</command>
219 </term>
220 <listitem>
221 <para>A component of <command>ip route</command>. This is for listing the routing
222 tables.
223 </para>
224 <indexterm zone="ch-system-iproute2 routel">
225 <primary sortas="b-routel">routel</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="rtacct">
231 <term>
232 <command>rtacct</command>
233 </term>
234 <listitem>
235 <para>Displays the contents of <filename>/proc/net/rt_acct</filename>.</para>
236 <indexterm zone="ch-system-iproute2 rtacct">
237 <primary sortas="b-rtacct">rtacct</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="rtmon">
243 <term>
244 <command>rtmon</command>
245 </term>
246 <listitem>
247 <para>Route monitoring utility.</para>
248 <indexterm zone="ch-system-iproute2 rtmon">
249 <primary sortas="b-rtmon">rtmon</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="rtpr">
255 <term>
256 <command>rtpr</command>
257 </term>
258 <listitem>
259 <para>Converts the output of <command>ip -o</command> back into a
260 readable form</para>
261 <indexterm zone="ch-system-iproute2 rtpr">
262 <primary sortas="b-rtpr">rtpr</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="rtstat">
268 <term>
269 <command>rtstat</command>
270 </term>
271 <listitem>
272 <para>Route status utility.</para>
273 <indexterm zone="ch-system-iproute2 rtstat">
274 <primary sortas="b-rtstat">rtstat</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="ss">
280 <term>
281 <command>ss</command>
282 </term>
283 <listitem>
284 <para>Similar to the <command>netstat</command> command; shows active connections.</para>
285 <indexterm zone="ch-system-iproute2 ss">
286 <primary sortas="b-ss">ss</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="tc">
292 <term>
293 <command>tc</command>
294 </term>
295 <listitem>
296 <para>Traffic Controlling Executable; this is for Quality Of
297Service (QOS) and Class Of Service (COS)
298 implementations
299 </para>
300
301 <para><command>tc qdisc</command> allows users to setup the queueing
302 discipline
303 </para>
304
305 <para><command>tc class</command> allows users to setup classes based on
306 the queuing discipline scheduling
307 </para>
308
309 <para><command>tc estimator</command> allows users to estimate the
310 network flow into a network
311 </para>
312
313 <para><command>tc filter</command> allows users to setup the QOS/COS
314 packet filtering
315 </para>
316
317 <para><command>tc policy</command> allows users to setup the QOS/COS
318 policies
319 </para>
320 <indexterm zone="ch-system-iproute2 ss">
321 <primary sortas="b-tc">tc</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325 </variablelist>
326 </sect2>
327</sect1>
328
Note: See TracBrowser for help on using the repository browser.