diff options
Diffstat (limited to 'chapter06/iproute2.xml')
| -rw-r--r-- | chapter06/iproute2.xml | 253 |
1 files changed, 228 insertions, 25 deletions
diff --git a/chapter06/iproute2.xml b/chapter06/iproute2.xml index 3cce62619..cf492bd64 100644 --- a/chapter06/iproute2.xml +++ b/chapter06/iproute2.xml @@ -3,16 +3,17 @@ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> -<sect1 id="ch-system-iproute2" xreflabel="IProute2" role="wrap"> -<title>Iproute2-&iproute2-version;</title> +<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> + <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> @@ -21,42 +22,244 @@ <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>Apply a patch</para> + <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> - <!--NEW--> - <para>The patch below fixes the issue with the newer versions of findutils, - the issue will give an error message it options are not in the proper order. - This patch corrects this issue for IPRoute2.</para> +<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> +<screen><userinput>patch -Np1 -i ../iproute2-&iproute2-patch-version;-find_update-1.patch</userinput></screen> - <para>Prepare iproute2 for compilation:</para> - + + <para>Prepare Iproute2 for compilation:</para> <screen><userinput>./configure </userinput></screen> <para>Compile the package:</para> <screen><userinput>make SBINDIR=/sbin</userinput></screen> - <para>Now install it:</para> - - <!--NEW--> - <screen><userinput>make install 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> - - <para>See testing</para> - + <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> + |