source: chapter06/iproute2.xml@ 0fb69dd

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/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,
    the issue will give an error message it options are not in the proper order.
    This patch corrects this issue for IPRoute2.</para>

    <screen><userinput>patch -Np1 -i ../iproute2-&iproute2-patch-version;-find_update-1.patch</userinput></screen>

    <para>This patch fixes a glibc error that could occur during compiling
    of iproute2.</para>

    <screen><userinput>patch -Np1 -i ../iproute2-&iproute2-patch-version;-free_error-2.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>
    <beginpage/>
  </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>