1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="ch-system-iproute2" role="wrap">
<title>Iproute2-&iproute2-version;</title>
<?dbhtml filename="iproute2.html"?>
<indexterm zone="ch-system-iproute2">
<primary sortas="a-iproute2">Iproute2</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Iproute2 package contains programs for basic and advanced
IPV4-based networking.
</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>.6 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>Iproute2 installation depends on</segtitle>
<seglistitem>
<seg>GCC, Glibc, Make, Linux-Headers, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Iproute2</title>
<para>The <command>arpd</command> binary included in this package is
dependent on Berkeley DB. Because <command>arpd</command> is not a very
common requirement on a base Linux system, remove the dependency on
Berkeley DB by applying the patch using the command below. If
the <command>arpd</command> binary is needed, instructions for
compiling Berkeley DB can be found in the BLFS Book at <ulink
url="&blfs-root;view/svn/content/databases.html#db"/>.
</para>
<screen><userinput>patch -Np1 -i ../iproute2-&iproute2-patch-version;-remove_db-1.patch</userinput></screen>
<para>The patch below fixes the issue with the newer versions of
findutils whose <command>find</command> command will report an error
message when its options are not in the proper order.</para>
<screen><userinput>patch -Np1 -i ../iproute2-&iproute2-patch-version;-find_update-1.patch</userinput></screen>
<para>Prepare Iproute2 for compilation:</para>
<screen><userinput>./configure </userinput></screen>
<para>Compile the package:</para>
<screen><userinput>make SBINDIR=/sbin</userinput></screen>
<para>The meaning of the make option:</para>
<variablelist>
<varlistentry>
<term><parameter>SBINDIR=/sbin</parameter></term>
<listitem><para>This makes sure that the Iproute2 binaries will install into
<filename class="directory">/sbin</filename>. This is the correct
location according to the FHS, because some of the Iproute2 binaries are used
in the bootscripts.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Install the package:</para>
<screen><userinput>make SBINDIR=/sbin install</userinput></screen>
</sect2>
<sect2 id="contents-iproute2" role="content">
<title>Contents of Iproute2</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem>
<seg>ifstat, ip, nstat, routef, routel, rtmon, rtstat, ss, and tc.</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<varlistentry id="ifstat">
<term>
<command>ifstat</command>
</term>
<listitem>
<para>Shows the interfaces statistic, including the amount of transmitted
and received packages by interface.</para>
<indexterm zone="ch-system-iproute2 ifstat">
<primary sortas="b-ifstat">ifstat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ip">
<term>
<command>ip</command>
</term>
<listitem>
<para>The main executable. It has several different functions:</para>
<para><command>ip link <replaceable>[device]</replaceable></command>
allows users to look at the state of devices and to make changes.
</para>
<para><command>ip addr</command> allows users to look at addresses and
their properties, add new addresses, and delete old ones.
</para>
<para><command>ip neighbor</command> allows users to look at
neighbor bindings and their properties, add new
neighbor entries, and delete old ones.
</para>
<para><command>ip rule</command> allows users to look at the routing
policies and change them.
</para>
<para><command>ip route</command> allows users to look at the routing
table and change routing table rules.
</para>
<para><command>ip tunnel</command> allows users to look at the IP
tunnels and their properties, and change them.
</para>
<para><command>ip maddr</command> allows users to look at the multicast
addresses and their properties, and change them.
</para>
<para><command>ip mroute</command> allows users to set, change, or
delete the multicast routing.
</para>
<para><command>ip monitor</command> allows users to
continously monitor the state of devices, addresses and routes.
</para>
<indexterm zone="ch-system-iproute2 ip">
<primary sortas="b-ip">ip</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="nstat">
<term>
<command>nstat</command>
</term>
<listitem>
<para>Shows network statistics.</para>
<indexterm zone="ch-system-iproute2 nstat">
<primary sortas="b-nstat">nstat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="routef">
<term>
<command>routef</command>
</term>
<listitem>
<para>A component of <command>ip route</command>. This is for flushing the routing
tables.
</para>
<indexterm zone="ch-system-iproute2 routef">
<primary sortas="b-routef">routef</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="routel">
<term>
<command>routel</command>
</term>
<listitem>
<para>A component of <command>ip route</command>. This is for listing the routing
tables.
</para>
<indexterm zone="ch-system-iproute2 routel">
<primary sortas="b-routel">routel</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rtmon">
<term>
<command>rtmon</command>
</term>
<listitem>
<para>Route monitoring utility.</para>
<indexterm zone="ch-system-iproute2 rtmon">
<primary sortas="b-rtmon">rtmon</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rtstat">
<term>
<command>rtstat</command>
</term>
<listitem>
<para>Route status utility</para>
<indexterm zone="ch-system-iproute2 rtstat">
<primary sortas="b-rtstat">rtstat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ss">
<term>
<command>ss</command>
</term>
<listitem>
<para>Similar to the <command>netstat</command> command; shows active connections</para>
<indexterm zone="ch-system-iproute2 ss">
<primary sortas="b-ss">ss</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="tc">
<term>
<command>tc</command>
</term>
<listitem>
<para>Traffic Controlling Executable; this is for Quality Of
Service (QOS) and Class Of Service (COS)
implementations
</para>
<para><command>tc qdisc</command> allows users to setup the queueing
discipline
</para>
<para><command>tc class</command> allows users to setup classes based on
the queuing discipline scheduling
</para>
<para><command>tc estimator</command> allows users to estimate the
network flow into a network
</para>
<para><command>tc filter</command> allows users to setup the QOS/COS
packet filtering
</para>
<para><command>tc policy</command> allows users to setup the QOS/COS
policies
</para>
<indexterm zone="ch-system-iproute2 ss">
<primary sortas="b-tc">tc</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
|