r2581 - in trunk/BOOK: appendices basicnet/netprogs introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Fri Aug 6 16:16:40 PDT 2004


Author: randy
Date: 2004-08-06 17:16:37 -0600 (Fri, 06 Aug 2004)
New Revision: 2581

Modified:
   trunk/BOOK/appendices/glossary.xml
   trunk/BOOK/basicnet/netprogs/net-tools.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
Added patches and modified the build instructions for Net-tools; updated Glossary

Modified: trunk/BOOK/appendices/glossary.xml
===================================================================
--- trunk/BOOK/appendices/glossary.xml	2004-08-06 20:28:54 UTC (rev 2580)
+++ trunk/BOOK/appendices/glossary.xml	2004-08-06 23:16:37 UTC (rev 2581)
@@ -374,6 +374,9 @@
 <glossentry id="gMIDI"><glossterm><acronym>MIDI</acronym></glossterm>
 <glossdef><para>Musical Instrument Digital Interface</para></glossdef></glossentry>
 
+<glossentry id="gMII"><glossterm><acronym>MII</acronym></glossterm>
+<glossdef><para>Media Independent Interface</para></glossdef></glossentry>
+
 <glossentry id="gMIME"><glossterm><acronym>MIME</acronym></glossterm>
 <glossdef><para>Multipurpose Internet Mail Extensions</para></glossdef></glossentry>
 

Modified: trunk/BOOK/basicnet/netprogs/net-tools.xml
===================================================================
--- trunk/BOOK/basicnet/netprogs/net-tools.xml	2004-08-06 20:28:54 UTC (rev 2580)
+++ trunk/BOOK/basicnet/netprogs/net-tools.xml	2004-08-06 23:16:37 UTC (rev 2581)
@@ -5,17 +5,21 @@
   %general-entities;
 
   <!ENTITY net-tools-download-http "http://www.tazenda.demon.co.uk/phil/net-tools/net-tools-&net-tools-version;.tar.bz2">
-  <!ENTITY net-tools-download-ftp  " ">
+  <!ENTITY net-tools-download-ftp  "ftp://ftp.ibiblio.org/pub/Linux/distributions/rootlinux/rootlinux-1.3/source/base/net-tools/net-tools-&net-tools-version;.tar.gz">
   <!ENTITY net-tools-size          "194 KB">
-  <!ENTITY net-tools-buildsize     "9.4 MB">
+  <!ENTITY net-tools-buildsize     "4.3 MB">
   <!ENTITY net-tools-time          "0.10 SBU">
+  <!ENTITY lfs-coreutils-version   "5.2.1">
 ]>
 
 <sect1 id="net-tools" xreflabel="Net-tools-&net-tools-version;">
+<sect1info>
+<othername>$LastChangedBy$</othername>
+<date>$Date$</date>
+</sect1info>
 <?dbhtml filename="net-tools.html"?>
 <title>Net-tools-&net-tools-version;</title>
 
-
 <sect2>
 <title>Introduction to <application>Net-tools</application></title>
 
@@ -32,22 +36,34 @@
 <listitem><para>Estimated build time: &net-tools-time;</para></listitem></itemizedlist>
 </sect3>
 
-<!--
 <sect3><title>Additional downloads</title>
 <itemizedlist spacing="compact">
-<listitem><para>Required Patch: <ulink
+<listitem><para>Required Patch (if compiling using 
+<application>GCC</application>-3.4.x): <ulink
 url="&patch-root;/net-tools-&net-tools-version;-gcc34-3.patch"/></para></listitem>
-</itemizedlist></sect3>
--->
+<listitem><para>Required Patch (if using LFS >= 6.0): <ulink
+url="&patch-root;/net-tools-&net-tools-version;-kernel_headers-2.patch"/></para>
+</listitem></itemizedlist></sect3>
 
 </sect2>
 
 <sect2>
 <title>Installation of <application>Net-tools</application></title>
 
+<note><para>The <application>Net-tools</application> package installs a 
+<command>hostname</command> program which will overwrite the existing program 
+installed by <application>Coreutils</application> during a base 
+<acronym>LFS</acronym> installation. If, for whatever reason, you need to 
+reinstall the <application>Coreutils</application> package after installing 
+<application>Net-tools</application>, you should use the 
+<filename>coreutils-&lfs-coreutils-version;-suppress_hostname_uptime_kill_su-1.patch</filename> 
+patch if you wish to preserve the <application>Net-tools</application> 
+<command>hostname</command> program.</para></note>
+
 <para>If you don't know what to answer to all the questions asked during
 the <command>make config</command> phase below, then just accept the
-defaults. This will be just fine in the majority of cases. What you're
+defaults (the build command below automates this). This will be just fine 
+in the majority of cases. What you're
 asked here is a bunch of questions about which network protocols you've
 enabled in your kernel. The default answers will enable the tools from
 this package to work with the most common protocols:
@@ -57,22 +73,16 @@
 protocols in its programs, but it's up to the kernel to make the
 protocols available.</para>
 
-<!--
-<para>This package has issues with being compiled by
-<application><acronym>GCC</acronym></application> 3.4, which we fix by
-applying the following patch:</para>
-
-<screen><userinput><command>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-3.patch</command></userinput></screen>
-
-<para>Fix an issue that arises when building against Linux 2.6:</para>
-
-<screen><userinput><command>sed -i 's at x25_address@struct &@' lib/x25_sr.c</command></userinput></screen>
--->
-
 <para>Install <application>Net-tools</application> by running the
 following commands:</para>
 
-<screen><userinput><command>yes "" | make config &&
+<screen><userinput><command>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-3.patch &&
+patch -Np1 -i ../net-tools-&net-tools-version;-kernel_headers-2.patch &&
+yes "" | make config &&
+sed -i -e 's|HAVE_IP_TOOLS 0|HAVE_IP_TOOLS 1|g' \
+       -e 's|HAVE_MII 0|HAVE_MII 1|g' config.h &&
+sed -i -e 's|# HAVE_IP_TOOLS=0|HAVE_IP_TOOLS=1|g' \
+       -e 's|# HAVE_MII=0|HAVE_MII=1|g' config.make &&
 make &&
 make update</command></userinput></screen>
 
@@ -81,10 +91,14 @@
 <sect2>
 <title>Command explanations</title>
 
-<para><command>yes "" | make config</command>:
-We skip all the questions and accept the defaults.
-</para>
+<para><command>yes "" | make config</command>: Piping <command>yes</command> 
+to <command>make config</command> skips the interactive configuration and
+accepts the defaults.</para>
 
+<para><command>sed -i -e ...</command>: These two <command>sed</command>s
+change the configuration files to force building the 
+<command>ipmaddr</command>, <command>iptunnel</command> and 
+<command>mii-tool</command> programs.</para>
 </sect2>
 
 <sect2>
@@ -96,6 +110,9 @@
 <command>domainname</command>,
 <command>hostname</command>,
 <command>ifconfig</command>,
+<command>ipmaddr</command>,
+<command>iptunnel</command>,
+<command>mii-tool</command>,
 <command>nameif</command>,
 <command>netstat</command>,
 <command>nisdomainname</command>,
@@ -136,6 +153,22 @@
 is the main utility for configuring network interfaces.
 </para></sect3>
 
+<sect3><title>ipmaddr</title>
+<para><command>ipmaddr</command> 
+adds, deletes and shows an interface's multicast address.
+</para></sect3>
+
+<sect3><title>iptunnel</title>
+<para><command>iptunnel</command> 
+adds, changes, deletes and shows an interface's tunnels.  
+</para></sect3>
+
+<sect3><title>mii-tool</title>
+<para><command>mii-tool</command> 
+checks or sets the status of a network interface's Media Independent 
+Interface (<acronym>MII</acronym>) unit.
+</para></sect3>
+
 <sect3><title>nameif</title>
 <para><command>nameif</command>
 names network interfaces based on <acronym>MAC</acronym> addresses.

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2004-08-06 20:28:54 UTC (rev 2580)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2004-08-06 23:16:37 UTC (rev 2581)
@@ -19,7 +19,8 @@
 <itemizedlist>
 
 <listitem><para>August 6th, 2004 [randy]: Updated to
-OpenLDAP-2.2.13 and Speex-1.0.4.</para></listitem>
+OpenLDAP-2.2.13 and Speex-1.0.4; added patches and modified build
+instructions for Net-tools; updated Glossary.</para></listitem>
 
 <listitem><para>August 5th, 2004 [igor]: Updated to
 Firefox-0.9.3.</para></listitem>




More information about the blfs-book mailing list