Ignore:
Timestamp:
03/22/2020 03:52:07 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
254bc90d
Parents:
dcee7a56
Message:

Format netprogs

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • networking/netprogs/net-tools.xml

    rdcee7a56 rb51fe6e  
    3030    <title>Introduction to Net-tools</title>
    3131
    32     <para>The <application>Net-tools</application> package is a collection
    33     of programs for controlling the network subsystem of the Linux
    34     kernel.</para>
     32    <para>
     33      The <application>Net-tools</application> package is a collection
     34      of programs for controlling the network subsystem of the Linux kernel.
     35    </para>
    3536
    3637    &lfs91_checked;
    … …  
    3940    <itemizedlist spacing="compact">
    4041      <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: &net-tools-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &net-tools-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &net-tools-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &net-tools-time;</para>
     42        <para>
     43          Download (HTTP): <ulink url="&net-tools-download-http;"/>
     44        </para>
     45      </listitem>
     46      <listitem>
     47        <para>
     48          Download (FTP): <ulink url="&net-tools-download-ftp;"/>
     49        </para>
     50      </listitem>
     51      <listitem>
     52        <para>
     53          Download MD5 sum: &net-tools-md5sum;
     54        </para>
     55      </listitem>
     56      <listitem>
     57        <para>
     58          Download size: &net-tools-size;
     59        </para>
     60      </listitem>
     61      <listitem>
     62        <para>
     63          Estimated disk space required: &net-tools-buildsize;
     64        </para>
     65      </listitem>
     66      <listitem>
     67        <para>
     68          Estimated build time: &net-tools-time;
     69        </para>
    5770      </listitem>
    5871    </itemizedlist>
    … …  
    7790    <title>Installation of Net-tools</title>
    7891
    79     <para id="net-tools-automate-example" xreflabel="Net-tools">The
    80     instructions below automate the configuration process by piping
    81     <command>yes</command> to the <command>make config</command> command. If
    82     you wish to run the interactive configuration process (by changing the
    83     instruction to just <command>make config</command>), but you are not sure
    84     how to answer all the questions, then just accept the defaults. This will
    85     be just fine in the majority of cases. What you're asked here is a bunch of
    86     questions about which network protocols you've enabled in your kernel. The
    87     default answers will enable the tools from this package to work with the
    88     most common protocols: TCP, PPP, and several others. You still need to
    89     actually enable these protocols in the kernel&mdash;what you do here is
    90     merely tell the package to include support for those protocols in its
    91     programs, but it's up to the kernel to make the protocols available.</para>
    92 
    93     <note><para>This package has several unneeded protocols and hardware device
    94     specific functions that are obsolete.  To only build the minimum needed for
    95     your system, skip the <command>yes</command> command and answer each
    96     question interactively.  The minimum needed options are 'UNIX protocol
    97     family' and 'INET (TCP/IP) protocol family'.</para></note>
    98 
    99     <para>The patch below cleans up the installation so that it does not
    100     overwrite the <application>ifconfig</application> and
    101     <application>hostname</application> programs that were installed in LFS.</para>
    102 
    103     <para>Install <application>Net-tools</application> by running the
    104     following commands:</para>
     92    <para id="net-tools-automate-example" xreflabel="Net-tools">
     93      The instructions below automate the configuration process by piping
     94      <command>yes</command> to the <command>make config</command> command.
     95      If you wish to run the interactive configuration process (by changing
     96      the instruction to just <command>make config</command>), but you are
     97      not sure how to answer all the questions, then just accept the defaults.
     98      This will be just fine in the majority of cases. What you're asked here
     99      is a bunch of questions about which network protocols you've enabled
     100      in your kernel. The default answers will enable the tools from this
     101      package to work with the most common protocols: TCP, PPP, and several
     102      others. You still need to actually enable these protocols in the
     103      kernel&mdash;what you do here is merely tell the package to include
     104      support for those protocols in its programs, but it's up to the kernel
     105      to make the protocols available.
     106    </para>
     107
     108    <note>
     109      <para>
     110        This package has several unneeded protocols and hardware device
     111        specific functions that are obsolete. To only build the minimum needed
     112        for your system, skip the <command>yes</command> command and answer
     113        each question interactively.  The minimum needed options are 'UNIX
     114        protocol family' and 'INET (TCP/IP) protocol family'.
     115      </para>
     116    </note>
     117
     118    <para>
     119      The patch below cleans up the installation so that it does not
     120      overwrite the <application>ifconfig</application> and
     121      <application>hostname</application> programs that were installed in LFS.
     122    </para>
     123
     124    <para>
     125      Install <application>Net-tools</application> by running the
     126      following commands:
     127    </para>
    105128
    106129<screen><userinput>patch -Np1 -i ../net-tools-&net-tools-version;-remove_dups-1.patch &amp;&amp;
    … …  
    110133make</userinput></screen>
    111134
    112     <para>This package does not come with a test suite.</para>
    113 
    114     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     135    <para>
     136      This package does not come with a test suite.
     137    </para>
     138
     139    <para>
     140      Now, as the <systemitem class="username">root</systemitem> user:
     141    </para>
    115142
    116143<screen role='root'><userinput>make update</userinput></screen>
    … …  
    121148    <title>Command Explanations</title>
    122149
    123     <para><command>sed -i '/#include &lt;netinet\/ip.h&gt;/d' iptunnel.c</command>:
    124     This fixes build breakage with linux-4.8 headers.</para>
     150    <para>
     151      <command>sed -i '/#include &lt;netinet\/ip.h&gt;/d' iptunnel.c</command>:
     152      This fixes build breakage with linux-4.8 headers.
     153    </para>
    125154<!--
    126     <para><command>sed -i -e '/Token/s/y$/n/' config.in</command>: Change the
    127     default for building obsolete token ring support to no.  This is a
    128     simpler change than changing the location for the token ring headers.
    129     </para>
    130 
    131     <para><command>sed -i -e '/HAVE_HWSTRIP/s/y$/n/' config.in</command>:
    132     Removes obsolete Metricom radio support that requires a header no longer
    133     included in the kernel.  </para>
     155    <para>
     156      <command>sed -i -e '/Token/s/y$/n/' config.in</command>: Change the
     157      default for building obsolete token ring support to no.  This is a
     158      simpler change than changing the location for the token ring headers.
     159    </para>
     160
     161    <para>
     162      <command>sed -i -e '/HAVE_HWSTRIP/s/y$/n/' config.in</command>:
     163      Removes obsolete Metricom radio support that requires a header no longer
     164      included in the kernel.
     165    </para>
    134166-->
    135     <para><command>yes "" | make config</command>: Piping <command>yes</command>
    136     to <command>make config</command> skips the interactive configuration and
    137     accepts the defaults.</para>
     167    <para>
     168      <command>yes "" | make config</command>: Piping <command>yes</command>
     169      to <command>make config</command> skips the interactive configuration and
     170      accepts the defaults.
     171    </para>
    138172
    139173  </sect2>
    … …  
    165199        <term><command>arp</command></term>
    166200        <listitem>
    167           <para>is used to manipulate the kernel's ARP cache, usually
    168           to add or delete an entry, or to dump the entire cache.</para>
     201          <para>
     202            is used to manipulate the kernel's ARP cache, usually
     203            to add or delete an entry, or to dump the entire cache.
     204          </para>
    169205          <indexterm zone="net-tools arp">
    170206            <primary sortas="b-arp">arp</primary>
    … …  
    176212        <term><command>dnsdomainname</command></term>
    177213        <listitem>
    178           <para>reports the system's DNS domain name.</para>
     214          <para>
     215            reports the system's DNS domain name.
     216          </para>
    179217          <indexterm zone="net-tools dnsdomainname">
    180218            <primary sortas="b-dnsdomainname">dnsdomainname</primary>
    … …  
    186224        <term><command>domainname</command></term>
    187225        <listitem>
    188           <para>reports or sets the system's NIS/YP domain name.</para>
     226          <para>
     227            reports or sets the system's NIS/YP domain name.
     228          </para>
    189229          <indexterm zone="net-tools domainname">
    190230            <primary sortas="b-domainname">domainname</primary>
    … …  
    196236        <term><command>hostname</command></term>
    197237        <listitem>
    198           <para>reports or sets the name of the current host system.</para>
     238          <para>
     239            reports or sets the name of the current host system.
     240          </para>
    199241          <indexterm zone="net-tools hostname">
    200242            <primary sortas="b-hostname">hostname</primary>
    … …  
    206248        <term><command>ifconfig</command></term>
    207249        <listitem>
    208           <para>is the main utility for configuring network interfaces.</para>
     250          <para>
     251            is the main utility for configuring network interfaces.
     252          </para>
    209253          <indexterm zone="net-tools ifconfig">
    210254            <primary sortas="b-ifconfig">ifconfig</primary>
    … …  
    216260        <term><command>ipmaddr</command></term>
    217261        <listitem>
    218           <para>adds, deletes and shows an interface's multicast addresses.</para>
     262          <para>
     263            adds, deletes and shows an interface's multicast addresses.
     264          </para>
    219265          <indexterm zone="net-tools ipmaddr">
    220266            <primary sortas="b-ipmaddr">ipmaddr</primary>
    … …  
    226272        <term><command>iptunnel</command></term>
    227273        <listitem>
    228           <para>adds, changes, deletes and shows an interface's tunnels.</para>
     274          <para>
     275            adds, changes, deletes and shows an interface's tunnels.
     276          </para>
    229277          <indexterm zone="net-tools iptunnel">
    230278            <primary sortas="b-iptunnel">iptunnel</primary>
    … …  
    236284        <term><command>mii-tool</command></term>
    237285        <listitem>
    238           <para>checks or sets the status of a network interface's Media Independent
    239           Interface (MII) unit.</para>
     286          <para>
     287            checks or sets the status of a network interface's Media
     288            Independent Interface (MII) unit.
     289          </para>
    240290          <indexterm zone="net-tools mii-tool">
    241291            <primary sortas="b-mii-tool">mii-tool</primary>
    … …  
    247297        <term><command>nameif</command></term>
    248298        <listitem>
    249           <para>names network interfaces based on MAC addresses.</para>
     299          <para>
     300            names network interfaces based on MAC addresses.
     301          </para>
    250302          <indexterm zone="net-tools nameif">
    251303            <primary sortas="b-nameif">nameif</primary>
    … …  
    257309        <term><command>netstat</command></term>
    258310        <listitem>
    259           <para>is used to report network connections, routing tables, and interface
    260           statistics.</para>
     311          <para>
     312            is used to report network connections, routing tables, and
     313            interface statistics.
     314          </para>
    261315          <indexterm zone="net-tools netstat">
    262316            <primary sortas="b-netstat">netstat</primary>
    … …  
    268322        <term><command>nisdomainname</command></term>
    269323        <listitem>
    270           <para>does the same as <command>domainname</command>.</para>
     324          <para>
     325            does the same as <command>domainname</command>.
     326          </para>
    271327          <indexterm zone="net-tools nisdomainname">
    272328            <primary sortas="b-nisdomainname">nisdomainname</primary>
    … …  
    278334        <term><command>plipconfig</command></term>
    279335        <listitem>
    280           <para>is used to fine tune the PLIP device parameters, to
    281           improve its performance.</para>
     336          <para>
     337            is used to fine tune the PLIP device parameters, to
     338            improve its performance.
     339          </para>
    282340          <indexterm zone="net-tools plipconfig">
    283341            <primary sortas="b-plipconfig">plipconfig</primary>
    … …  
    289347        <term><command>rarp</command></term>
    290348        <listitem>
    291           <para>is used to manipulate the kernel's RARP table.</para>
     349          <para>
     350            is used to manipulate the kernel's RARP table.
     351          </para>
    292352          <indexterm zone="net-tools rarp">
    293353            <primary sortas="b-rarp">rarp</primary>
    … …  
    299359        <term><command>route</command></term>
    300360        <listitem>
    301           <para>is used to manipulate the IP routing table.</para>
     361          <para>
     362            is used to manipulate the IP routing table.
     363          </para>
    302364          <indexterm zone="net-tools route">
    303365            <primary sortas="b-route">route</primary>
    … …  
    309371        <term><command>slattach</command></term>
    310372        <listitem>
    311           <para>attaches a network interface to a serial line. This allows you to use
    312           normal terminal lines for point-to-point links to other computers.</para>
     373          <para>
     374            attaches a network interface to a serial line. This allows you to
     375            use normal terminal lines for point-to-point links to others
     376            computers.
     377          </para>
    313378          <indexterm zone="net-tools slattach">
    314379            <primary sortas="b-slattach">slattach</primary>
    … …  
    320385        <term><command>ypdomainname</command></term>
    321386        <listitem>
    322           <para>does the same as <command>domainname</command>.</para>
     387          <para>
     388            does the same as <command>domainname</command>.
     389          </para>
    323390          <indexterm zone="net-tools ypdomainname">
    324391            <primary sortas="b-ypdomainname">ypdomainname</primary>
Note: See TracChangeset for help on using the changeset viewer.