BOOK/chapter08/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-fin-sbu;</seg>
  34         <seg>&inetutils-fin-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. One test, ping-localhost.sh, will fail if the host
 111     system does not have ipv6 capability.</para></note>
 112
 113     <para>Install the package:</para>
 114
 115 <screen><userinput remap="install">make install</userinput></screen>
 116
 117     <para>Move some programs so they are available if <filename
 118     class='directory'>/usr</filename> is not accessible:</para>
 119
 120 <screen><userinput remap="install">mv -v /usr/bin/{hostname,ping,ping6,traceroute} /bin
 121 mv -v /usr/bin/ifconfig /sbin</userinput></screen>
 122
 123   </sect2>
 124
 125   <sect2 id="contents-inetutils" role="content">
 126     <title>Contents of Inetutils</title>
 127
 128     <segmentedlist>
 129       <segtitle>Installed programs</segtitle>
 130
 131       <seglistitem>
 132         <seg>dnsdomainname, ftp, ifconfig, hostname, ping, ping6,
 133         talk, telnet, tftp, and traceroute</seg>
 134       </seglistitem>
 135     </segmentedlist>
 136
 137     <variablelist>
 138       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 139       <?dbfo list-presentation="list"?>
 140       <?dbhtml list-presentation="table"?>
 141
 142       <varlistentry id="dnsdomainname">
 143         <term><command>dnsdomainname</command></term>
 144         <listitem>
 145         <para>Show the system's DNS domain name</para>
 146         <indexterm zone="ch-system-inetutils dnsdomainname">
 147           <primary sortas="b-dnsdomainname">dnsdomainname</primary>
 148         </indexterm>
 149         </listitem>
 150       </varlistentry>
 151
 152       <varlistentry id="ftp">
 153         <term><command>ftp</command></term>
 154         <listitem>
 155         <para>Is the file transfer protocol program</para>
 156         <indexterm zone="ch-system-inetutils ftp">
 157           <primary sortas="b-ftp">ftp</primary>
 158         </indexterm>
 159         </listitem>
 160       </varlistentry>
 161
 162       <varlistentry id="hostname">
 163         <term><command>hostname</command></term>
 164         <listitem>
 165           <para>Reports or sets the name of the host</para>
 166           <indexterm zone="ch-system-inetutils hostname">
 167             <primary sortas="b-hostname">hostname</primary>
 168           </indexterm>
 169         </listitem>
 170       </varlistentry>
 171
 172       <varlistentry id="ifconfig">
 173         <term><command>ifconfig</command></term>
 174         <listitem>
 175         <para>Manages network interfaces</para>
 176         <indexterm zone="ch-system-inetutils ifconfig">
 177           <primary sortas="b-ifconfig">ifconfig</primary>
 178         </indexterm>
 179         </listitem>
 180       </varlistentry>
 181
 182       <varlistentry id="ping">
 183         <term><command>ping</command></term>
 184         <listitem>
 185           <para>Sends echo-request packets and reports how long the replies
 186           take</para>
 187           <indexterm zone="ch-system-inetutils ping">
 188             <primary sortas="b-ping">ping</primary>
 189           </indexterm>
 190         </listitem>
 191       </varlistentry>
 192
 193       <varlistentry id="ping6">
 194         <term><command>ping6</command></term>
 195         <listitem>
 196           <para>A version of <command>ping</command> for IPv6 networks</para>
 197           <indexterm zone="ch-system-inetutils ping6">
 198             <primary sortas="b-ping6">ping6</primary>
 199           </indexterm>
 200         </listitem>
 201       </varlistentry>
 202
 203       <varlistentry id="talk">
 204         <term><command>talk</command></term>
 205         <listitem>
 206           <para>Is used to chat with another user</para>
 207           <indexterm zone="ch-system-inetutils talk">
 208             <primary sortas="b-talk">talk</primary>
 209           </indexterm>
 210         </listitem>
 211       </varlistentry>
 212
 213       <varlistentry id="telnet">
 214         <term><command>telnet</command></term>
 215         <listitem>
 216           <para>An interface to the TELNET protocol</para>
 217           <indexterm zone="ch-system-inetutils telnet">
 218             <primary sortas="b-telnet">telnet</primary>
 219           </indexterm>
 220         </listitem>
 221       </varlistentry>
 222
 223       <varlistentry id="tftp">
 224         <term><command>tftp</command></term>
 225         <listitem>
 226           <para>A trivial file transfer program</para>
 227           <indexterm zone="ch-system-inetutils tftp">
 228             <primary sortas="b-tftp">tftp</primary>
 229           </indexterm>
 230         </listitem>
 231       </varlistentry>
 232
 233       <varlistentry id="traceroute">
 234         <term><command>traceroute</command></term>
 235         <listitem>
 236           <para>Traces the route your packets take from the host you are
 237           working on to another host on a network, showing all the intermediate
 238           hops (gateways) along the way</para>
 239           <indexterm zone="ch-system-inetutils traceroute">
 240             <primary sortas="b-traceroute">traceroute</primary>
 241           </indexterm>
 242         </listitem>
 243       </varlistentry>
 244
 245     </variablelist>
 246
 247   </sect2>
 248
 249 </sect1>