chapter06/inetutils.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-system-inetutils" role="wrap">
   9   <?dbhtml filename="inetutils.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>inetutils</productname>
  13     <productnumber>&inetutils-version;</productnumber>
  14     <address>&inetutils-url;</address>
  15   </sect1info>
  16
  17   <title>Inetutils-&inetutils-version;</title>
  18
  19   <indexterm zone="ch-system-inetutils">
  20     <primary sortas="a-Inetutils">Inetutils</primary>
  21   </indexterm>
  22
  23   <sect2 role="package">
  24     <title/>
  25
  26     <para>The Inetutils package contains programs for basic networking.</para>
  27
  28     <segmentedlist>
  29       <segtitle>&buildtime;</segtitle>
  30       <segtitle>&diskspace;</segtitle>
  31
  32       <seglistitem>
  33         <seg>&inetutils-ch6-sbu;</seg>
  34         <seg>&inetutils-ch6-du;</seg>
  35       </seglistitem>
  36     </segmentedlist>
  37
  38   </sect2>
  39
  40   <sect2 role="installation">
  41     <title>Installation of Inetutils</title>
  42
  43     <para>Prepare Inetutils for compilation:</para>
  44
  45 <screen><userinput remap="configure">./configure --prefix=/usr        \
  46             --localstatedir=/var \
  47             --disable-logger     \
  48             --disable-whois      \
  49             --disable-rcp        \
  50             --disable-rexec      \
  51             --disable-rlogin     \
  52             --disable-rsh        \
  53             --disable-servers</userinput></screen>
  54
  55     <variablelist>
  56       <title>The meaning of the configure options:</title>
  57
  58       <varlistentry>
  59         <term><parameter>--disable-logger</parameter></term>
  60         <listitem>
  61           <para>This option prevents Inetutils from installing the
  62           <command>logger</command> program, which is used by scripts to
  63           pass messages to the System Log Daemon. Do not install it because
  64           Util-linux installs a more recent version.</para>
  65         </listitem>
  66       </varlistentry>
  67
  68       <varlistentry>
  69         <term><parameter>--disable-whois</parameter></term>
  70         <listitem>
  71           <para>This option disables the building of the Inetutils
  72           <command>whois</command> client, which is out of date. Instructions for
  73           a better <command>whois</command> client are in the BLFS book.</para>
  74         </listitem>
  75       </varlistentry>
  76
  77       <varlistentry>
  78         <term><parameter>--disable-r*</parameter></term>
  79         <listitem>
  80           <para>These parameters disable building obsolete programs that should not
  81           be used due to security issues. The functions provided by these
  82           programs can be provided by the <application>openssh</application>
  83           package in the BLFS book.</para>
  84         </listitem>
  85       </varlistentry>
  86
  87       <varlistentry>
  88         <term><parameter>--disable-servers</parameter></term>
  89         <listitem>
  90           <para>This disables the installation of the various network servers
  91           included as part of the Inetutils package. These servers are deemed not
  92           appropriate in a basic LFS system. Some are insecure by nature and are
  93           only considered safe on trusted networks. Note that
  94           better replacements are available for many of these servers.</para>
  95         </listitem>
  96       </varlistentry>
  97
  98     </variablelist>
  99
 100     <para>Compile the package:</para>
 101
 102 <screen><userinput remap="make">make</userinput></screen>
 103
 104     <para>To test the results, issue:</para>
 105
 106 <screen><userinput remap="test">make check</userinput></screen>
 107
 108     <note><para>One test, libls.sh, may fail in the initial chroot
 109     environment but will pass if the test is rerun after the LFS system
 110     is complete.</para></note>
 111
 112     <para>Install the package:</para>
 113
 114 <screen><userinput remap="install">make install</userinput></screen>
 115
 116     <para>Move some programs so they are available if <filename
 117     class='directory'>/usr</filename> is not accessible:</para>
 118
 119 <screen><userinput remap="install">mv -v /usr/bin/{hostname,ping,ping6,traceroute} /bin
 120 mv -v /usr/bin/ifconfig /sbin</userinput></screen>
 121
 122   </sect2>
 123
 124   <sect2 id="contents-inetutils" role="content">
 125     <title>Contents of Inetutils</title>
 126
 127     <segmentedlist>
 128       <segtitle>Installed programs</segtitle>
 129
 130       <seglistitem>
 131         <seg>dnsdomainname, ftp, ifconfig, hostname, ping, ping6,
 132         talk, telnet, tftp, and traceroute</seg>
 133       </seglistitem>
 134     </segmentedlist>
 135
 136     <variablelist>
 137       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 138       <?dbfo list-presentation="list"?>
 139       <?dbhtml list-presentation="table"?>
 140
 141       <varlistentry id="dnsdomainname">
 142         <term><command>dnsdomainname</command></term>
 143         <listitem>
 144         <para>Show the system's DNS domain name</para>
 145         <indexterm zone="ch-system-inetutils dnsdomainname">
 146           <primary sortas="b-dnsdomainname">dnsdomainname</primary>
 147         </indexterm>
 148         </listitem>
 149       </varlistentry>
 150
 151       <varlistentry id="ftp">
 152         <term><command>ftp</command></term>
 153         <listitem>
 154         <para>Is the file transfer protocol program</para>
 155         <indexterm zone="ch-system-inetutils ftp">
 156           <primary sortas="b-ftp">ftp</primary>
 157         </indexterm>
 158         </listitem>
 159       </varlistentry>
 160
 161       <varlistentry id="hostname">
 162         <term><command>hostname</command></term>
 163         <listitem>
 164           <para>Reports or sets the name of the host</para>
 165           <indexterm zone="ch-system-inetutils hostname">
 166             <primary sortas="b-hostname">hostname</primary>
 167           </indexterm>
 168         </listitem>
 169       </varlistentry>
 170
 171       <varlistentry id="ifconfig">
 172         <term><command>ifconfig</command></term>
 173         <listitem>
 174         <para>Manages network interfaces</para>
 175         <indexterm zone="ch-system-inetutils ifconfig">
 176           <primary sortas="b-ifconfig">ifconfig</primary>
 177         </indexterm>
 178         </listitem>
 179       </varlistentry>
 180
 181       <varlistentry id="ping">
 182         <term><command>ping</command></term>
 183         <listitem>
 184           <para>Sends echo-request packets and reports how long the replies
 185           take</para>
 186           <indexterm zone="ch-system-inetutils ping">
 187             <primary sortas="b-ping">ping</primary>
 188           </indexterm>
 189         </listitem>
 190       </varlistentry>
 191
 192       <varlistentry id="ping6">
 193         <term><command>ping6</command></term>
 194         <listitem>
 195           <para>A version of <command>ping</command> for IPv6 networks</para>
 196           <indexterm zone="ch-system-inetutils ping6">
 197             <primary sortas="b-ping6">ping6</primary>
 198           </indexterm>
 199         </listitem>
 200       </varlistentry>
 201
 202       <varlistentry id="talk">
 203         <term><command>talk</command></term>
 204         <listitem>
 205           <para>Is used to chat with another user</para>
 206           <indexterm zone="ch-system-inetutils talk">
 207             <primary sortas="b-talk">talk</primary>
 208           </indexterm>
 209         </listitem>
 210       </varlistentry>
 211
 212       <varlistentry id="telnet">
 213         <term><command>telnet</command></term>
 214         <listitem>
 215           <para>An interface to the TELNET protocol</para>
 216           <indexterm zone="ch-system-inetutils telnet">
 217             <primary sortas="b-telnet">telnet</primary>
 218           </indexterm>
 219         </listitem>
 220       </varlistentry>
 221
 222       <varlistentry id="tftp">
 223         <term><command>tftp</command></term>
 224         <listitem>
 225           <para>A trivial file transfer program</para>
 226           <indexterm zone="ch-system-inetutils tftp">
 227             <primary sortas="b-tftp">tftp</primary>
 228           </indexterm>
 229         </listitem>
 230       </varlistentry>
 231
 232       <varlistentry id="traceroute">
 233         <term><command>traceroute</command></term>
 234         <listitem>
 235           <para>Traces the route your packets take from the host you are
 236           working on to another host on a network, showing all the intermediate
 237           hops (gateways) along the way</para>
 238           <indexterm zone="ch-system-inetutils traceroute">
 239             <primary sortas="b-traceroute">traceroute</primary>
 240           </indexterm>
 241         </listitem>
 242       </varlistentry>
 243
 244     </variablelist>
 245
 246   </sect2>
 247
 248 </sect1>