inetutils.xml 8.1 KB

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