r3347 - in trunk/BOOK: . basicnet/netutils introduction/welcome postlfs/security stylesheets stylesheets/pdf stylesheets/xhtml

randy at linuxfromscratch.org randy at linuxfromscratch.org
Thu Jan 27 15:19:32 PST 2005


Author: randy
Date: 2005-01-27 16:19:30 -0700 (Thu, 27 Jan 2005)
New Revision: 3347

Modified:
   trunk/BOOK/basicnet/netutils/ethereal.xml
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/postlfs/security/firewalling.xml
   trunk/BOOK/stylesheets/lfs-l10n.xml
   trunk/BOOK/stylesheets/pdf/lfs-index.xsl
   trunk/BOOK/stylesheets/xhtml/lfs-index.xsl
Log:
Updated to Ethereal-0.10.9; added new Index division 'Kernel Configuration'

Modified: trunk/BOOK/basicnet/netutils/ethereal.xml
===================================================================
--- trunk/BOOK/basicnet/netutils/ethereal.xml	2005-01-27 18:24:29 UTC (rev 3346)
+++ trunk/BOOK/basicnet/netutils/ethereal.xml	2005-01-27 23:19:30 UTC (rev 3347)
@@ -6,10 +6,10 @@
 
   <!ENTITY ethereal-download-http "http://www.ethereal.com/distribution/ethereal-&ethereal-version;.tar.bz2">
   <!ENTITY ethereal-download-ftp  "ftp://ftp.ethereal.com/pub/ethereal/all-versions/ethereal-&ethereal-version;.tar.bz2">
-  <!ENTITY ethereal-md5sum        "eebd6cc45a45d68332b2c053aac0c484">
-  <!ENTITY ethereal-size          "5.1 MB">
-  <!ENTITY ethereal-buildsize     "179 MB">
-  <!ENTITY ethereal-time          "3.61 SBU">
+  <!ENTITY ethereal-md5sum        "f8b7a2c2dcf273e7fd755f972167dacb">
+  <!ENTITY ethereal-size          "5.4 MB">
+  <!ENTITY ethereal-buildsize     "194 MB">
+  <!ENTITY ethereal-time          "3.78 SBU">
 ]>
 
 <sect1 id="ethereal" xreflabel="Ethereal-&ethereal-version;">
@@ -19,6 +19,9 @@
 </sect1info>
 <?dbhtml filename="ethereal.html"?>
 <title>Ethereal-&ethereal-version;</title>
+<indexterm zone="ethereal">
+<primary sortas="a-Ethereal">Ethereal</primary>
+</indexterm>
 
 <sect2>
 <title>Introduction to <application>Ethereal</application></title>
@@ -80,9 +83,12 @@
 
 <screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
     --enable-randpkt --enable-threads &&
-make &&
-make install</command></userinput></screen>
+make</command></userinput></screen>
 
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
+
 </sect2>
 
 <sect2>
@@ -94,14 +100,24 @@
 <para><option>--enable-threads</option>: This parameter enables the use 
 of threads in <command>ethereal</command>.</para>
 
+<para><option>--with-ssl</option>: This parameter enables the use of the 
+<application>Open<acronym>SSL</acronym></application> 
+<filename class='libraryfile'>libcrypto</filename> library.</para>
+
 </sect2>
 
 <sect2>
 <title>Configuring <application>Ethereal</application></title>
 
-<sect3><title>Config files</title>
+<sect3 id="ethereal-config"><title>Config files</title>
 <para><filename>/etc/ethereal.conf</filename> and 
 <filename>~/.ethereal/preferences</filename></para>
+<indexterm zone="ethereal ethereal-config">
+<primary sortas="e-AA.ethereal-preferences">~/.ethereal/preferences</primary>
+</indexterm>
+<indexterm zone="ethereal ethereal-config">
+<primary sortas="e-etc-ethereal.conf">/etc/ethereal.conf</primary>
+</indexterm>
 </sect3>
 
 <sect3><title>Configuration Information</title>
@@ -115,7 +131,7 @@
 <acronym>GUI</acronym> interface.</para>
 </sect4>
 
-<sect4><title>Kernel configuration</title>
+<sect4 id="ethereal-kernel"><title>Kernel configuration</title>
 <para>The kernel must have the Packet protocol enabled for 
 <application>Ethereal</application> to capture live packets from the network. 
 Enable the Packet protocol by choosing <quote>Y</quote> in the 
@@ -123,6 +139,10 @@
 – <quote>Networking options</quote> – <quote>Packet socket</quote> 
 configuration parameter. Alternatively, build the af_packet module by choosing 
 <quote>M</quote> in this parameter.</para>
+<indexterm zone="ethereal ethereal-kernel">
+<primary sortas="d-Capturing-network-packets">Capturing network 
+packets</primary>
+</indexterm>
 
 <para>Note: If you want to look at packets, make sure you don't filter 
 them out with <xref linkend="iptables"/>. If you want to exclude 
@@ -137,77 +157,132 @@
 <sect2>
 <title>Contents</title>
 
-<para>The <application>Ethereal</application> package contains 
-<command>capinfos</command>, 
-<command>dftest</command>, 
-<command>editcap</command>, 
-<command>ethereal</command>, 
-<command>idl2eth</command>, 
-<command>mergecap</command>, 
-<command>randpkt</command>, 
-<command>tethereal</command>, 
-<command>text2pcap</command>, 
-<filename class='libraryfile'>libethereal</filename>, 
-<filename class='libraryfile'>libwiretap</filename> and 
-many dissector plugin modules.</para>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
 
-</sect2>
+<seglistitem>
+<seg>capinfos, dftest, editcap, ethereal, idl2eth, mergecap, randpkt, 
+tethereal and text2pcap</seg>
+<seg>libethereal.so, libwiretap.so and numerous dissector plugin modules</seg>
+<seg>/usr/lib/ethereal and /usr/share/ethereal</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect2><title>Description</title>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>capinfos</title>
-<para><command>capinfos</command> reads a saved capture file and returns any or 
-all of several statistics about that file. It is able to detect and read any 
-capture supported by the <application>Ethereal</application> package.</para>
-</sect3>
+<varlistentry id="capinfos">
+<term><command>capinfos</command></term>
+<listitem><para>reads a saved capture file and returns any or all of several 
+statistics about that file. It is able to detect and read any capture 
+supported by the <application>Ethereal</application> package.</para>
+<indexterm zone="ethereal capinfos">
+<primary sortas="b-capinfos">capinfos</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>dftest</title>
-<para><command>dftest</command> is a display-filter-compiler test 
-program.</para>
-</sect3>
+<varlistentry id="dftest">
+<term><command>dftest</command></term>
+<listitem><para>is a display-filter-compiler test program.</para>
+<indexterm zone="ethereal dftest">
+<primary sortas="b-dftest">dftest</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>editcap</title>
-<para><command>editcap</command> edits and/or translates the format of capture 
-files. It knows how to read <application>libpcap</application> capture files, 
-including those of <command>tcpdump</command>, 
-<application>Ethereal</application> and other tools that write captures in that 
-format.</para>
-</sect3>
+<varlistentry id="editcap">
+<term><command>editcap</command></term>
+<listitem><para>edits and/or translates the format of capture files. It knows 
+how to read <application>libpcap</application> capture files, including those 
+of <command>tcpdump</command>, <application>Ethereal</application> and other 
+tools that write captures in that format.</para>
+<indexterm zone="ethereal editcap">
+<primary sortas="b-editcap">editcap</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>ethereal</title>
-<para><command>ethereal</command> is a <acronym>GUI</acronym> network protocol 
-analyzer. It lets you interactively browse packet data from a live network or 
-from a previously saved capture file.</para>
-</sect3>
+<varlistentry id="ethereal-prog">
+<term><command>ethereal</command></term>
+<listitem><para>is a <acronym>GUI</acronym> network protocol analyzer. It lets 
+you interactively browse packet data from a live network or from a previously 
+saved capture file.</para>
+<indexterm zone="ethereal ethereal-prog">
+<primary sortas="b-ethereal">ethereal</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>idl2eth</title>
-<para><command>idl2eth</command> takes a user specified 
-<acronym>CORBA</acronym> <acronym>IDL</acronym> file and generates 
-<quote>C</quote> source code that can be used to create an 
-<application>Ethereal</application> plugin.</para>
-</sect3>
+<varlistentry id="idl2eth">
+<term><command>idl2eth</command></term>
+<listitem><para>takes a user specified <acronym>CORBA</acronym> 
+<acronym>IDL</acronym> file and generates <quote>C</quote> source code that 
+can be used to create an <application>Ethereal</application> plugin.</para>
+<indexterm zone="ethereal idl2eth">
+<primary sortas="b-idl2eth">idl2eth</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>mergecap</title>
-<para><command>mergecap</command> combines multiple saved capture files into a 
-single output file.</para>
-</sect3>
+<varlistentry id="mergecap">
+<term><command>mergecap</command></term>
+<listitem><para>combines multiple saved capture files into a single output 
+file.</para>
+<indexterm zone="ethereal mergecap">
+<primary sortas="b-mergecap">mergecap</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>randpkt</title>
-<para><command>randpkt</command> creates random-packet capture files.</para>
-</sect3>
+<varlistentry id="randpkt">
+<term><command>randpkt</command></term>
+<listitem><para>creates random-packet capture files.</para>
+<indexterm zone="ethereal randpkt">
+<primary sortas="b-randpkt">randpkt</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>tethereal</title>
-<para><command>tethereal</command> is a <acronym>TTY</acronym>-mode network 
-protocol analyzer. It lets you capture packet data from a live network or
-read packets from a previously saved capture file.</para>
-</sect3>
+<varlistentry id="tethereal">
+<term><command>tethereal</command></term>
+<listitem><para>is a <acronym>TTY</acronym>-mode network protocol analyzer. 
+It lets you capture packet data from a live network or read packets from a 
+previously saved capture file.</para>
+<indexterm zone="ethereal tethereal">
+<primary sortas="b-tethereal">tethereal</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>text2pcap</title>
-<para><command>text2pcap</command> reads in an <acronym>ASCII</acronym> hex 
-dump and writes the data described into a 
-<application>libpcap</application>-style capture file.</para>
-</sect3>
+<varlistentry id="text2pcap">
+<term><command>text2pcap</command></term>
+<listitem><para>reads in an <acronym>ASCII</acronym> hex dump and writes the 
+data described into a <application>libpcap</application>-style capture 
+file.</para>
+<indexterm zone="ethereal text2pcap">
+<primary sortas="b-text2pcap">text2pcap</primary>
+</indexterm></listitem>
+</varlistentry>
 
+<varlistentry id="libethereal">
+<term><filename class='libraryfile'>libethereal.so</filename></term>
+<listitem><para>contains functions used by the 
+<application>Ethereal</application> programs to perform filtering and 
+packet capturing.</para>
+<indexterm zone="ethereal libethereal">
+<primary sortas="c-libethereal">libethereal.so</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="libwiretap">
+<term><filename class='libraryfile'>libwiretap.so</filename></term>
+<listitem><para>is a library being developed as a future replacement for 
+<filename class='libraryfile'>libpcap</filename>, the current standard Unix 
+library for packet capturing. For more information, see the 
+<filename>README</filename> file in the source 
+<filename class='directory'>wiretap</filename> directory.</para>
+<indexterm zone="ethereal libwiretap">
+<primary sortas="c-libwiretap">libwiretap.so</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
+
 </sect2>
 
 </sect1>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-01-27 18:24:29 UTC (rev 3346)
+++ trunk/BOOK/general.ent	2005-01-27 23:19:30 UTC (rev 3347)
@@ -226,7 +226,7 @@
 <!ENTITY nmap-version                 "3.75">  
 <!ENTITY whois-version                "4.6.26">
 <!ENTITY bind-version                 "9.3.0"> 
-<!ENTITY ethereal-version             "0.10.7"> 
+<!ENTITY ethereal-version             "0.10.9"> 
                                   
 <!-- Chapter 20 -->               
 <!ENTITY nail-version                 "11.19"> 

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-01-27 18:24:29 UTC (rev 3346)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-01-27 23:19:30 UTC (rev 3347)
@@ -22,8 +22,9 @@
 
 <itemizedlist>
 
-<listitem><para>January 27th, 2005 [randy]: Updated to 
-Heimdal-0.6.3; updated Glossary.</para></listitem>
+<listitem><para>January 27th, 2005 [randy]: Updated to Heimdal-0.6.3 and 
+Ethereal-0.10.9; updated Glossary; added new Index division, "Kernel 
+Configuration".</para></listitem>
 
 <listitem><para>January 26th, 2005 [randy]: Updated J2SDK binary version to 
 1.4.2_07; updated J2SDK build entities; added download location and build 

Modified: trunk/BOOK/postlfs/security/firewalling.xml
===================================================================
--- trunk/BOOK/postlfs/security/firewalling.xml	2005-01-27 18:24:29 UTC (rev 3346)
+++ trunk/BOOK/postlfs/security/firewalling.xml	2005-01-27 23:19:30 UTC (rev 3347)
@@ -129,6 +129,9 @@
 
 <sect2 id="fw-kernel" xreflabel="getting a firewalling-enabled Kernel">
 <title>Getting a firewall enabled Kernel</title>
+<indexterm zone="fw-kernel">
+<primary sortas="d-Firewalls">Firewalls (using iptables)</primary>
+</indexterm>
 
 <para>If you want your Linux-Box to have a firewall, you must first ensure 
 that your kernel has been compiled with the relevant options turned on.

Modified: trunk/BOOK/stylesheets/lfs-l10n.xml
===================================================================
--- trunk/BOOK/stylesheets/lfs-l10n.xml	2005-01-27 18:24:29 UTC (rev 3346)
+++ trunk/BOOK/stylesheets/lfs-l10n.xml	2005-01-27 23:19:30 UTC (rev 3347)
@@ -13,7 +13,7 @@
     <l:gentext key="Others" text=""/>
     <l:gentext key="Packages" text=""/>
     <l:gentext key="Programs" text=""/>
-    <l:gentext key="Scripts" text=""/>
+    <l:gentext key="Kernel Configuration" text=""/>
 
   </l:l10n>
 
@@ -28,7 +28,7 @@
     <l:gentext key="Others" text="Others"/>
     <l:gentext key="Packages" text="Packages"/>
     <l:gentext key="Programs" text="Programs"/>
-    <l:gentext key="Scripts" text="Scripts"/>
+    <l:gentext key="Kernel Configuration" text="Kernel Configuration"/>
 
   </l:l10n>
 
@@ -43,7 +43,7 @@
     <l:gentext key="Others" text="Otros"/>
     <l:gentext key="Packages" text="Paquetes"/>
     <l:gentext key="Programs" text="Programas"/>
-    <l:gentext key="Scripts" text="Guiones"/>
+    <l:gentext key="Kernel Configuration" text="Configuración del núcleo"/>
 
   </l:l10n>
 

Modified: trunk/BOOK/stylesheets/pdf/lfs-index.xsl
===================================================================
--- trunk/BOOK/stylesheets/pdf/lfs-index.xsl	2005-01-27 18:24:29 UTC (rev 3346)
+++ trunk/BOOK/stylesheets/pdf/lfs-index.xsl	2005-01-27 23:19:30 UTC (rev 3347)
@@ -48,7 +48,7 @@
                 </xsl:when>
                 <xsl:when test="$divtitle = 'D'">
                   <xsl:call-template name="gentext">
-                    <xsl:with-param name="key">Scripts</xsl:with-param>
+                    <xsl:with-param name="key">Kernel Configuration</xsl:with-param>
                   </xsl:call-template>
                 </xsl:when>
                 <xsl:when test="$divtitle = 'E'">

Modified: trunk/BOOK/stylesheets/xhtml/lfs-index.xsl
===================================================================
--- trunk/BOOK/stylesheets/xhtml/lfs-index.xsl	2005-01-27 18:24:29 UTC (rev 3346)
+++ trunk/BOOK/stylesheets/xhtml/lfs-index.xsl	2005-01-27 23:19:30 UTC (rev 3347)
@@ -53,7 +53,7 @@
               	<xsl:text>Libraries</xsl:text>
              </xsl:when>
              <xsl:when test="$divtitle = 'D'">
-              	<xsl:text>Scripts</xsl:text>
+              	<xsl:text>Kernel Configuration</xsl:text>
              </xsl:when>
              <xsl:when test="$divtitle = 'E'">
               	<xsl:text>Configuration Files</xsl:text>




More information about the blfs-book mailing list