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>Create a definition to allow the <command>ifconfig</command> program
  44     to build properly:</para>
  45
  46 <screen><userinput remap="pre">echo '#define PATH_PROCNET_DEV "/proc/net/dev"' &gt;&gt; ifconfig/system/linux.h </userinput></screen>
  47 -->
  48     <para>Prepare Inetutils for compilation:</para>
  49
  50 <screen><userinput remap="configure">./configure --prefix=/usr        \
  51             --localstatedir=/var \
  52             --disable-logger     \
  53             --disable-whois      \
  54             --disable-rcp        \
  55             --disable-rexec      \
  56             --disable-rlogin     \
  57             --disable-rsh        \
  58             --disable-servers</userinput></screen>
  59
  60     <variablelist>
  61       <title>The meaning of the configure options:</title>
  62
  63       <varlistentry>
  64         <term><parameter>--disable-logger</parameter></term>
  65         <listitem>
  66           <para>This option prevents Inetutils from installing the
  67           <command>logger</command> program, which is used by scripts to
  68           pass messages to the System Log Daemon. Do not install it because
  69           Util-linux installs a more recent version.</para>
  70         </listitem>
  71       </varlistentry>
  72
  73       <varlistentry>
  74         <term><parameter>--disable-whois</parameter></term>
  75         <listitem>
  76           <para>This option disables the building of the Inetutils
  77           <command>whois</command> client, which is out of date. Instructions for
  78           a better <command>whois</command> client are in the BLFS book.</para>
  79         </listitem>
  80       </varlistentry>
  81
  82       <varlistentry>
  83         <term><parameter>--disable-r*</parameter></term>
  84         <listitem>
  85           <para>These parameters disable building obsolete programs that should not
  86           be used due to security issues. The functions provided by these
  87           programs can be provided by the <application>openssh</application>
  88           package in the BLFS book.</para>
  89         </listitem>
  90       </varlistentry>
  91
  92       <varlistentry>
  93         <term><parameter>--disable-servers</parameter></term>
  94         <listitem>
  95           <para>This disables the installation of the various network servers
  96           included as part of the Inetutils package. These servers are deemed not
  97           appropriate in a basic LFS system. Some are insecure by nature and are
  98           only considered safe on trusted networks. Note that
  99           better replacements are available for many of these servers.</para>
 100         </listitem>
 101       </varlistentry>
 102
 103     </variablelist>
 104
 105     <para>Compile the package:</para>
 106
 107 <screen><userinput remap="make">make</userinput></screen>
 108
 109     <para>To test the results, issue:</para>
 110
 111 <screen><userinput remap="test">make check</userinput></screen>
 112
 113     <para>One test, <emphasis>libls.sh</emphasis>, is known to fail due to hard
 114     coding of some support program paths.  All tests pass if the tests are
 115     rerun at the end of Chapter 6.</para>
 116
 117     <para>Install the package:</para>
 118
 119 <screen><userinput remap="install">make install</userinput></screen>
 120
 121     <para>Move some programs so they are available if <filename
 122     class='directory'>/usr</filename> is not accessible:</para>
 123
 124 <screen><userinput remap="install">mv -v /usr/bin/{hostname,ping,ping6,traceroute} /bin
 125 mv -v /usr/bin/ifconfig /sbin</userinput></screen>
 126
 127   </sect2>
 128
 129   <sect2 id="contents-inetutils" role="content">
 130     <title>Contents of Inetutils</title>
 131
 132     <segmentedlist>
 133       <segtitle>Installed programs</segtitle>
 134
 135       <seglistitem>
 136         <seg>dnsdomainname, ftp, ifconfig, hostname, ping, ping6,
 137         talk, telnet, tftp, and traceroute</seg>
 138       </seglistitem>
 139     </segmentedlist>
 140
 141     <variablelist>
 142       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 143       <?dbfo list-presentation="list"?>
 144       <?dbhtml list-presentation="table"?>
 145
 146       <varlistentry id="dnsdomainname">
 147         <term><command>dnsdomainname</command></term>
 148         <listitem>
 149         <para>Show the system's DNS domain name</para>
 150         <indexterm zone="ch-system-inetutils dnsdomainname">
 151           <primary sortas="b-dnsdomainname">dnsdomainname</primary>
 152         </indexterm>
 153         </listitem>
 154       </varlistentry>
 155
 156       <varlistentry id="ftp">
 157         <term><command>ftp</command></term>
 158         <listitem>
 159         <para>Is the file transfer protocol program</para>
 160         <indexterm zone="ch-system-inetutils ftp">
 161           <primary sortas="b-ftp">ftp</primary>
 162         </indexterm>
 163         </listitem>
 164       </varlistentry>
 165
 166       <varlistentry id="hostname">
 167         <term><command>hostname</command></term>
 168         <listitem>
 169           <para>Reports or sets the name of the host</para>
 170           <indexterm zone="ch-system-inetutils hostname">
 171             <primary sortas="b-hostname">hostname</primary>
 172           </indexterm>
 173         </listitem>
 174       </varlistentry>
 175
 176       <varlistentry id="ifconfig">
 177         <term><command>ifconfig</command></term>
 178         <listitem>
 179         <para>Manages network interfaces</para>
 180         <indexterm zone="ch-system-inetutils ifconfig">
 181           <primary sortas="b-ifconfig">ifconfig</primary>
 182         </indexterm>
 183         </listitem>
 184       </varlistentry>
 185
 186       <varlistentry id="ping">
 187         <term><command>ping</command></term>
 188         <listitem>
 189           <para>Sends echo-request packets and reports how long the replies
 190           take</para>
 191           <indexterm zone="ch-system-inetutils ping">
 192             <primary sortas="b-ping">ping</primary>
 193           </indexterm>
 194         </listitem>
 195       </varlistentry>
 196
 197       <varlistentry id="ping6">
 198         <term><command>ping6</command></term>
 199         <listitem>
 200           <para>A version of <command>ping</command> for IPv6 networks</para>
 201           <indexterm zone="ch-system-inetutils ping6">
 202             <primary sortas="b-ping6">ping6</primary>
 203           </indexterm>
 204         </listitem>
 205       </varlistentry>
 206
 207       <varlistentry id="talk">
 208         <term><command>talk</command></term>
 209         <listitem>
 210           <para>Is used to chat with another user</para>
 211           <indexterm zone="ch-system-inetutils talk">
 212             <primary sortas="b-talk">talk</primary>
 213           </indexterm>
 214         </listitem>
 215       </varlistentry>
 216
 217       <varlistentry id="telnet">
 218         <term><command>telnet</command></term>
 219         <listitem>
 220           <para>An interface to the TELNET protocol</para>
 221           <indexterm zone="ch-system-inetutils telnet">
 222             <primary sortas="b-telnet">telnet</primary>
 223           </indexterm>
 224         </listitem>
 225       </varlistentry>
 226
 227       <varlistentry id="tftp">
 228         <term><command>tftp</command></term>
 229         <listitem>
 230           <para>A trivial file transfer program</para>
 231           <indexterm zone="ch-system-inetutils tftp">
 232             <primary sortas="b-tftp">tftp</primary>
 233           </indexterm>
 234         </listitem>
 235       </varlistentry>
 236
 237       <varlistentry id="traceroute">
 238         <term><command>traceroute</command></term>
 239         <listitem>
 240           <para>Traces the route your packets take from the host you are
 241           working on to another host on a network, showing all the intermediate
 242           hops (gateways) along the way</para>
 243           <indexterm zone="ch-system-inetutils traceroute">
 244             <primary sortas="b-traceroute">traceroute</primary>
 245           </indexterm>
 246         </listitem>
 247       </varlistentry>
 248
 249     </variablelist>
 250
 251   </sect2>
 252
 253 </sect1>