Changeset a3dbd17b


Ignore:
Timestamp:
04/30/2005 10:46:26 AM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
c174c5f
Parents:
17929f0
Message:

Tagged net-tools.xml.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3864 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • basicnet/netprogs/net-tools.xml

    r17929f0 ra3dbd17b  
    1616
    1717<sect1 id="net-tools" xreflabel="Net-tools-&net-tools-version;">
    18 <sect1info>
    19 <othername>$LastChangedBy$</othername>
    20 <date>$Date$</date>
    21 </sect1info>
    22 <?dbhtml filename="net-tools.html"?>
    23 <title>Net-tools-&net-tools-version;</title>
    24 
    25 <sect2>
    26 <title>Introduction to <application>Net-tools</application></title>
    27 
    28 <para>The <application>Net-tools</application> package is a collection
    29 of programs for controlling the network subsystem of the Linux
    30 kernel.</para>
    31 
    32 <sect3><title>Package information</title>
    33 <itemizedlist spacing='compact'>
    34 <listitem><para>Download (HTTP):
    35 <ulink url="&net-tools-download-http;"/></para></listitem>
    36 <listitem><para>Download (FTP):
    37 <ulink url="&net-tools-download-ftp;"/></para></listitem>
    38 <listitem><para>Download MD5 sum (HTTP):
    39 &net-tools-md5sum-http;</para></listitem>
    40 <listitem><para>Download MD5 sum (FTP):
    41 &net-tools-md5sum-ftp;</para></listitem>
    42 <listitem><para>Download size: &net-tools-size;</para></listitem>
    43 <listitem><para>Estimated disk space required:
    44 &net-tools-buildsize;</para></listitem>
    45 <listitem><para>Estimated build time:
    46 &net-tools-time;</para></listitem></itemizedlist>
    47 </sect3>
    48 
    49 <sect3><title>Additional downloads</title>
    50 <itemizedlist spacing="compact">
    51 <listitem><para>Required Patch (if compiled using
    52 <application>GCC</application>-3.4.x): <ulink
    53 url="&patch-root;/net-tools-&net-tools-version;-gcc34-3.patch"/></para>
    54 </listitem>
    55 <listitem><para>Required Patch: <ulink
    56 url="&patch-root;/net-tools-&net-tools-version;-kernel_headers-2.patch"/></para>
    57 </listitem>
    58 <listitem><para>Required Patch: <ulink
    59 url="&patch-root;/net-tools-&net-tools-version;-mii_ioctl-1.patch"/></para>
    60 </listitem></itemizedlist>
    61 </sect3>
    62 
    63 </sect2>
    64 
    65 <sect2>
    66 <title>Installation of <application>Net-tools</application></title>
    67 
    68 <note><para>The <application>Net-tools</application> package installs a
    69 <command>hostname</command> program which will overwrite the existing program
    70 installed by <application>Coreutils</application> during a base
    71 <acronym>LFS</acronym> installation. If, for whatever reason, you need to
    72 reinstall the <application>Coreutils</application> package after installing
    73 <application>Net-tools</application>, you should use the
    74 <filename>coreutils-&lfs-coreutils-version;-suppress_hostname_uptime_kill_su-1.patch</filename>
    75 patch if you wish to preserve the <application>Net-tools</application>
    76 <command>hostname</command> program.</para></note>
    77 
    78 <para>If you don't know what to answer to all the questions asked during
    79 the <command>make config</command> phase below, then just accept the
    80 defaults (the build command below automates this). This will be just fine
    81 in the majority of cases. What you're
    82 asked here is a bunch of questions about which network protocols you've
    83 enabled in your kernel. The default answers will enable the tools from
    84 this package to work with the most common protocols:
    85 <acronym>TCP</acronym>, <acronym>PPP</acronym>, and several others. You
    86 still need to actually enable these protocols in the kernel&mdash;what you
    87 do here is merely telling the package to include support for those
    88 protocols in its programs, but it's up to the kernel to make the
    89 protocols available.</para>
    90 
    91 <para>Install <application>Net-tools</application> by running the
    92 following commands:</para>
    93 
    94 <screen><userinput><command>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-3.patch &amp;&amp;
     18  <?dbhtml filename="net-tools.html"?>
     19 
     20  <sect1info>
     21    <othername>$LastChangedBy$</othername>
     22    <date>$Date$</date>
     23  </sect1info>
     24 
     25  <title>Net-tools-&net-tools-version;</title>
     26 
     27  <indexterm zone="net-tools">
     28    <primary sortas="a-Net-tools">Net-tools</primary>
     29  </indexterm>
     30
     31  <sect2 role="package">
     32    <title>Introduction to Net-tools</title>
     33   
     34    <para>The <application>Net-tools</application> package is a collection
     35    of programs for controlling the network subsystem of the Linux
     36    kernel.</para>
     37   
     38    <bridgehead renderas="sect3">Package Information</bridgehead>
     39    <itemizedlist spacing="compact">
     40      <listitem>
     41        <para>Download (HTTP): <ulink url="&net-tools-download-http;"/></para>
     42      </listitem>
     43      <listitem>
     44        <para>Download (FTP): <ulink url="&net-tools-download-ftp;"/></para>
     45      </listitem>
     46      <listitem>
     47        <para>Download MD5 sum (HTTP): &net-tools-md5sum-http;</para>
     48      </listitem>
     49      <listitem>
     50        <para>Download MD5 sum (FTP): &net-tools-md5sum-ftp;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Download size: &net-tools-size;</para>
     54      </listitem>
     55      <listitem>
     56        <para>Estimated disk space required: &net-tools-buildsize;</para>
     57      </listitem>
     58      <listitem>
     59      <para>Estimated build time: &net-tools-time;</para></listitem>
     60    </itemizedlist>
     61   
     62    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     63    <itemizedlist spacing="compact">
     64      <listitem>
     65        <para>Required Patch (if compiled using
     66        <application>GCC</application>-3.4.x): <ulink
     67        url="&patch-root;/net-tools-&net-tools-version;-gcc34-3.patch"/></para>
     68      </listitem>
     69      <listitem>
     70        <para>Required Patch: <ulink
     71        url="&patch-root;/net-tools-&net-tools-version;-kernel_headers-2.patch"/></para>
     72      </listitem>
     73      <listitem>
     74        <para>Required Patch: <ulink
     75        url="&patch-root;/net-tools-&net-tools-version;-mii_ioctl-1.patch"/></para>
     76      </listitem>
     77    </itemizedlist>
     78   
     79  </sect2>
     80 
     81  <sect2 role="installation">
     82    <title>Installation of Net-tools</title>
     83
     84    <note>
     85      <para>The <application>Net-tools</application> package installs a
     86      <command>hostname</command> program which will overwrite the existing program
     87      installed by <application>Coreutils</application> during a base
     88      LFS installation. If, for whatever reason, you need to
     89      reinstall the <application>Coreutils</application> package after installing
     90      <application>Net-tools</application>, you should use the
     91      <filename>coreutils-&lfs-coreutils-version;-suppress_hostname_uptime_kill_su-1.patch</filename>
     92      patch if you wish to preserve the <application>Net-tools</application>
     93      <command>hostname</command> program.</para>
     94    </note>
     95   
     96    <para>If you don't know what to answer to all the questions asked during
     97    the <command>make config</command> phase below, then just accept the
     98    defaults (the build command below automates this). This will be just fine
     99    in the majority of cases. What you're
     100    asked here is a bunch of questions about which network protocols you've
     101    enabled in your kernel. The default answers will enable the tools from
     102    this package to work with the most common protocols:
     103    TCP, PPP, and several others. You
     104    still need to actually enable these protocols in the kernel&mdash;what you
     105    do here is merely telling the package to include support for those
     106    protocols in its programs, but it's up to the kernel to make the
     107    protocols available.</para>
     108   
     109    <para>Install <application>Net-tools</application> by running the
     110    following commands:</para>
     111
     112<screen><userinput>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-3.patch &amp;&amp;
    95113patch -Np1 -i ../net-tools-&net-tools-version;-kernel_headers-2.patch &amp;&amp;
    96114patch -Np1 -i ../net-tools-&net-tools-version;-mii_ioctl-1.patch &amp;&amp;
    … …  
    101119       -e 's|# HAVE_MII=0|HAVE_MII=1|g' config.make &amp;&amp;
    102120make &amp;&amp;
    103 make update</command></userinput></screen>
    104 
    105 </sect2>
    106 
    107 <sect2>
    108 <title>Command explanations</title>
    109 
    110 <para><command>yes "" | make config</command>: Piping <command>yes</command>
    111 to <command>make config</command> skips the interactive configuration and
    112 accepts the defaults.</para>
    113 
    114 <para><command>sed -i -e ...</command>: These two <command>sed</command>s
    115 change the configuration files to force building the
    116 <command>ipmaddr</command>, <command>iptunnel</command> and
    117 <command>mii-tool</command> programs.</para>
    118 </sect2>
    119 
    120 <sect2>
    121 <title>Contents</title>
    122 
    123 <para>The <application>Net-tools</application> package contains
    124 <command>arp</command>,
    125 <command>dnsdomainname</command>,
    126 <command>domainname</command>,
    127 <command>hostname</command>,
    128 <command>ifconfig</command>,
    129 <command>ipmaddr</command>,
    130 <command>iptunnel</command>,
    131 <command>mii-tool</command>,
    132 <command>nameif</command>,
    133 <command>netstat</command>,
    134 <command>nisdomainname</command>,
    135 <command>plipconfig</command>,
    136 <command>rarp</command>,
    137 <command>route</command>,
    138 <command>slattach</command> and
    139 <command>ypdomainname</command>.</para>
    140 
    141 </sect2>
    142 
    143 <sect2><title>Description</title>
    144 
    145 <sect3><title>arp</title>
    146 <para><command>arp</command>
    147 is used to manipulate the kernel's <acronym>ARP</acronym> cache, usually
    148 to add or delete an entry, or to dump the entire cache.
    149 </para></sect3>
    150 
    151 <sect3><title>dnsdomainname</title>
    152 <para><command>dnsdomainname</command>
    153 reports the system's <acronym>DNS</acronym> domain name.
    154 </para></sect3>
    155 
    156 <sect3><title>domainname</title>
    157 <para><command>domainname</command>
    158 reports or sets the system's
    159 <acronym>NIS</acronym>/<acronym>YP</acronym> domain name.
    160 </para></sect3>
    161 
    162 <sect3><title>hostname</title>
    163 <para><command>hostname</command>
    164 reports or sets the name of the current host system.
    165 </para></sect3>
    166 
    167 <sect3><title>ifconfig</title>
    168 <para><command>ifconfig</command>
    169 is the main utility for configuring network interfaces.
    170 </para></sect3>
    171 
    172 <sect3><title>ipmaddr</title>
    173 <para><command>ipmaddr</command>
    174 adds, deletes and shows an interface's multicast addresses.
    175 </para></sect3>
    176 
    177 <sect3><title>iptunnel</title>
    178 <para><command>iptunnel</command>
    179 adds, changes, deletes and shows an interface's tunnels. 
    180 </para></sect3>
    181 
    182 <sect3><title>mii-tool</title>
    183 <para><command>mii-tool</command>
    184 checks or sets the status of a network interface's Media Independent
    185 Interface (<acronym>MII</acronym>) unit.
    186 </para></sect3>
    187 
    188 <sect3><title>nameif</title>
    189 <para><command>nameif</command>
    190 names network interfaces based on <acronym>MAC</acronym> addresses.
    191 </para></sect3>
    192 
    193 <sect3><title>netstat</title>
    194 <para><command>netstat</command>
    195 is used to report network connections, routing tables, and interface
    196 statistics.
    197 </para></sect3>
    198 
    199 <sect3><title>nisdomainname</title>
    200 <para><command>nisdomainname</command>
    201 does the same as <command>domainname</command>.
    202 </para></sect3>
    203 
    204 <sect3><title>plipconfig</title>
    205 <para><command>plipconfig</command>
    206 is used to fine tune the <acronym>PLIP</acronym> device parameters, to
    207 improve its performance.
    208 </para></sect3>
    209 
    210 <sect3><title>rarp</title>
    211 <para><command>rarp</command>
    212 is used to manipulate the kernel's <acronym>RARP</acronym> table.
    213 </para></sect3>
    214 
    215 <sect3><title>route</title>
    216 <para><command>route</command>
    217 is used to manipulate the <acronym>IP</acronym> routing table.
    218 </para></sect3>
    219 
    220 <sect3><title>slattach</title>
    221 <para><command>slattach</command>
    222 attaches a network interface to a serial line. This allows you to use
    223 normal terminal lines for point-to-point links to other computers.
    224 </para></sect3>
    225 
    226 <sect3><title>ypdomainname</title>
    227 <para><command>ypdomainname</command>
    228 does the same as <command>domainname</command>.
    229 </para></sect3>
    230 
    231 </sect2>
    232 
     121make update</userinput></screen>
     122   
     123  </sect2>
     124 
     125  <sect2 role="commands">
     126    <title>Command Explanations</title>
     127
     128    <para><command>yes "" | make config</command>: Piping <command>yes</command>
     129    to <command>make config</command> skips the interactive configuration and
     130    accepts the defaults.</para>
     131   
     132    <para><command>sed -i -e ...</command>: These two <command>sed</command>s
     133    change the configuration files to force building the
     134    <command>ipmaddr</command>, <command>iptunnel</command> and
     135    <command>mii-tool</command> programs.</para>
     136   
     137  </sect2>
     138 
     139  <sect2 role="content">
     140    <title>Contents</title>
     141   
     142    <segmentedlist>
     143      <segtitle>Installed Programs</segtitle>
     144      <segtitle>Installed Libraries</segtitle>
     145      <segtitle>Installed Directories</segtitle>
     146     
     147      <seglistitem>
     148        <seg>arp, dnsdomainname, domainname, hostname,
     149        ifconfig, ipmaddr, iptunnel, mii-tool, nameif, netstat,
     150        nisdomainname, plipconfig, rarp, route, slattach, and
     151        ypdomainname</seg>
     152        <seg>None</seg>
     153        <seg>None</seg>
     154      </seglistitem>
     155    </segmentedlist>
     156   
     157    <variablelist>
     158      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     159      <?dbfo list-presentation="list"?>
     160      <?dbhtml list-presentation="table"?>
     161     
     162      <varlistentry id="arp">
     163        <term><command>arp</command></term>
     164        <listitem>
     165          <para>is used to manipulate the kernel's ARP cache, usually
     166          to add or delete an entry, or to dump the entire cache.</para>
     167          <indexterm zone="net-tools arp">
     168            <primary sortas="b-arp">arp</primary>
     169          </indexterm>
     170        </listitem>
     171      </varlistentry>
     172     
     173      <varlistentry id="dnsdomainname">
     174        <term><command>dnsdomainname</command></term>
     175        <listitem>
     176          <para>reports the system's DNS domain name.</para>
     177          <indexterm zone="net-tools dnsdomainname">
     178            <primary sortas="b-dnsdomainname">dnsdomainname</primary>
     179          </indexterm>
     180        </listitem>
     181      </varlistentry>
     182     
     183      <varlistentry id="domainname">
     184        <term><command>domainname</command></term>
     185        <listitem>
     186          <para>reports or sets the system's NIS/YP domain name.</para>
     187          <indexterm zone="net-tools domainname">
     188            <primary sortas="b-domainname">domainname</primary>
     189          </indexterm>
     190        </listitem>
     191      </varlistentry>
     192     
     193      <varlistentry id="hostname">
     194        <term><command>hostname</command></term>
     195        <listitem>
     196          <para>reports or sets the name of the current host system.</para>
     197          <indexterm zone="net-tools hostname">
     198            <primary sortas="b-hostname">hostname</primary>
     199          </indexterm>
     200        </listitem>
     201      </varlistentry>
     202     
     203      <varlistentry id="ifconfig">
     204        <term><command>ifconfig</command></term>
     205        <listitem>
     206          <para>is the main utility for configuring network interfaces.</para>
     207          <indexterm zone="net-tools ifconfig">
     208            <primary sortas="b-ifconfig">ifconfig</primary>
     209          </indexterm>
     210        </listitem>
     211      </varlistentry>
     212     
     213      <varlistentry id="ipmaddr">
     214        <term><command>ipmaddr</command></term>
     215        <listitem>
     216          <para>adds, deletes and shows an interface's multicast addresses.</para>
     217          <indexterm zone="net-tools ipmaddr">
     218            <primary sortas="b-ipmaddr">ipmaddr</primary>
     219          </indexterm>
     220        </listitem>
     221      </varlistentry>
     222     
     223      <varlistentry id="iptunnel">
     224        <term><command>iptunnel</command></term>
     225        <listitem>
     226          <para>adds, changes, deletes and shows an interface's tunnels.</para>
     227          <indexterm zone="net-tools iptunnel">
     228            <primary sortas="b-iptunnel">iptunnel</primary>
     229          </indexterm>
     230        </listitem>
     231      </varlistentry>
     232     
     233      <varlistentry id="mii-tool">
     234        <term><command>mii-tool</command></term>
     235        <listitem>
     236          <para>checks or sets the status of a network interface's Media Independent
     237          Interface (MII) unit.</para>
     238          <indexterm zone="net-tools mii-tool">
     239            <primary sortas="b-mii-tool">mii-tool</primary>
     240          </indexterm>
     241        </listitem>
     242      </varlistentry>
     243     
     244      <varlistentry id="nameif">
     245        <term><command>nameif</command></term>
     246        <listitem>
     247          <para>names network interfaces based on MAC addresses.</para>
     248          <indexterm zone="net-tools nameif">
     249            <primary sortas="b-nameif">nameif</primary>
     250          </indexterm>
     251        </listitem>
     252      </varlistentry>
     253     
     254      <varlistentry id="netstat">
     255        <term><command>netstat</command></term>
     256        <listitem>
     257          <para>is used to report network connections, routing tables, and interface
     258          statistics.</para>
     259          <indexterm zone="net-tools netstat">
     260            <primary sortas="b-netstat">netstat</primary>
     261          </indexterm>
     262        </listitem>
     263      </varlistentry>
     264     
     265      <varlistentry id="nisdomainname">
     266        <term><command>nisdomainname</command></term>
     267        <listitem>
     268          <para>does the same as <command>domainname</command>.</para>
     269          <indexterm zone="net-tools nisdomainname">
     270            <primary sortas="b-nisdomainname">nisdomainname</primary>
     271          </indexterm>
     272        </listitem>
     273      </varlistentry>
     274     
     275      <varlistentry id="plipconfig">
     276        <term><command>plipconfig</command></term>
     277        <listitem>
     278          <para>is used to fine tune the PLIP device parameters, to
     279          improve its performance.</para>
     280          <indexterm zone="net-tools plipconfig">
     281            <primary sortas="b-plipconfig">plipconfig</primary>
     282          </indexterm>
     283        </listitem>
     284      </varlistentry>
     285     
     286      <varlistentry id="rarp">
     287        <term><command>rarp</command></term>
     288        <listitem>
     289          <para>is used to manipulate the kernel's RARP table.</para>
     290          <indexterm zone="net-tools rarp">
     291            <primary sortas="b-rarp">rarp</primary>
     292          </indexterm>
     293        </listitem>
     294      </varlistentry>
     295     
     296      <varlistentry id="route">
     297        <term><command>route</command></term>
     298        <listitem>
     299          <para>is used to manipulate the IP routing table.</para>
     300          <indexterm zone="net-tools route">
     301            <primary sortas="b-route">route</primary>
     302          </indexterm>
     303        </listitem>
     304      </varlistentry>
     305     
     306      <varlistentry id="slattach">
     307        <term><command>slattach</command></term>
     308        <listitem>
     309          <para>attaches a network interface to a serial line. This allows you to use
     310          normal terminal lines for point-to-point links to other computers.</para>
     311          <indexterm zone="net-tools slattach">
     312            <primary sortas="b-slattach">slattach</primary>
     313          </indexterm>
     314        </listitem>
     315      </varlistentry>
     316     
     317      <varlistentry id="ypdomainname">
     318        <term><command>ypdomainname</command></term>
     319        <listitem>
     320          <para>does the same as <command>domainname</command>.</para>
     321          <indexterm zone="net-tools ypdomainname">
     322            <primary sortas="b-ypdomainname">ypdomainname</primary>
     323          </indexterm>
     324        </listitem>
     325      </varlistentry>
     326     
     327    </variablelist>
     328   
     329  </sect2>
     330 
    233331</sect1>
Note: See TracChangeset for help on using the changeset viewer.