source: clfs-sysroot/BOOK/final-system/common/inetutils.xml@ aa7d916

<?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-inetutils" role="wrap">
  <?dbhtml filename="inetutils.html"?>

  <title>Inetutils-&inetutils-version;</title>

  <indexterm zone="ch-system-inetutils">
    <primary sortas="a-Inetutils">Inetutils</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The Inetutils package contains programs for basic networking.</para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Inetutils</title>

    <para os="s1">The following set of seds prevent binaries from being installed as root</para>

<screen os="s2"><userinput>for dir in ping rcp rlogin rsh; do
    cp ${dir}/Makefile.in{,.orig}
    sed '/^SUIDMODE =/s/-o root//' ${dir}/Makefile.in.orig &gt; ${dir}/Makefile.in
done</userinput></screen>

    <para os="a">Prepare Inetutils for compilation:</para>

<screen os="b"><userinput>./configure --build=${CLFS_HOST} --host=${CLFS_TARGET} \
    --prefix=/usr --libexecdir=/usr/sbin --sysconfdir=/etc \
    --localstatedir=/var --disable-logger --disable-syslogd \
    --disable-whois --disable-servers</userinput></screen>

    <variablelist os="c">
      <title>The meaning of the configure options:</title>

      <varlistentry>
        <term><parameter>--disable-logger</parameter></term>
        <listitem>
          <para>This option prevents Inetutils from installing the
          <command>logger</command> program, which is used by scripts to
          pass messages to the System Log Daemon. Do not install it because
          Util-linux installs a better version later.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--disable-syslogd</parameter></term>
        <listitem>
          <para>This option prevents Inetutils from installing the System Log
          Daemon, which is installed with the Sysklogd package.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--disable-whois</parameter></term>
        <listitem>
          <para>This option disables the building of the Inetutils
          <command>whois</command> client, which is out of date.
          Instructions for a better <command>whois</command> client are
          in the BLFS book.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--disable-servers</parameter></term>
        <listitem>
          <para>This disables the installation of the various network
          servers included as part of the Inetutils package. These servers are
          deemed not appropriate in a basic CLFS system. Some are insecure by
          nature and are only considered safe on trusted networks. More
          information can be found at <ulink
          url="&blfs-root;view/svn/basicnet/inetutils.html"/>. Note that
          better replacements are available for many of these
          servers.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para os="d">Compile the package:</para>

<screen os="e"><userinput>make</userinput></screen>

    <para os="f">Install the package:</para>

<screen os="g"><userinput>make DESTDIR=${CLFS} install</userinput></screen>

    <para os="h">Move the <command>ping</command> and <command>ping6</command>
    program to its FHS-compliant place:</para>

<screen os="i"><userinput>mv -v ${CLFS}/usr/bin/ping{,6} ${CLFS}/bin</userinput></screen>

  </sect2>

  <sect2 id="contents-inetutils" role="content">
    <title>Contents of Inetutils</title>

    <segmentedlist>
      <segtitle>Installed programs</segtitle>

      <seglistitem>
        <seg>ftp, ifconfig, ping, ping6, rcp, rlogin, rsh, talk, telnet, and tftp</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="ftp">
        <term><command>ftp</command></term>
        <listitem>
          <para>Is the file transfer protocol program</para>
          <indexterm zone="ch-system-inetutils ftp">
            <primary sortas="b-ftp">ftp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ifconfig">
        <term><command>ifconfig</command></term>
        <listitem>
          <para>Utility for configuring network interfaces</para>
          <indexterm zone="ch-system-inetutils ifconfig">
            <primary sortas="b-ifconfig">ifconfig</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ping">
        <term><command>ping</command></term>
        <listitem>
          <para>Sends echo-request packets and reports how long the replies
          take</para>
          <indexterm zone="ch-system-inetutils ping">
            <primary sortas="b-ping">ping</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ping6">
        <term><command>ping6</command></term>
        <listitem>
          <para>Sends echo-request packets and reports how long the replies
          take this is the IPV6 version</para>
          <indexterm zone="ch-system-inetutils ping6">
            <primary sortas="b-ping6">ping6</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="rcp">
        <term><command>rcp</command></term>
        <listitem>
          <para>Performs remote file copy</para>
          <indexterm zone="ch-system-inetutils rcp">
            <primary sortas="b-rcp">rcp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="rlogin">
        <term><command>rlogin</command></term>
        <listitem>
          <para>Performs remote login</para>
          <indexterm zone="ch-system-inetutils rlogin">
            <primary sortas="b-rlogin">rlogin</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="rsh">
        <term><command>rsh</command></term>
        <listitem>
          <para>Runs a remote shell</para>
          <indexterm zone="ch-system-inetutils rsh">
            <primary sortas="b-rsh">rsh</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="talk">
        <term><command>talk</command></term>
        <listitem>
          <para>Is used to chat with another user</para>
          <indexterm zone="ch-system-inetutils talk">
            <primary sortas="b-talk">talk</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="telnet">
        <term><command>telnet</command></term>
        <listitem>
          <para>An interface to the TELNET protocol</para>
          <indexterm zone="ch-system-inetutils telnet">
            <primary sortas="b-telnet">telnet</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tftp">
        <term><command>tftp</command></term>
        <listitem>
          <para>A trivial file transfer program</para>
          <indexterm zone="ch-system-inetutils tftp">
            <primary sortas="b-tftp">tftp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>