Updated to Ethereal-0.10.9; added new Index division 'Kernel Configuration'

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3347 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Randy McMurchy 2005-01-27 23:19:30 +00:00
parent dcee0f2f13
commit a56c29d32a
7 changed files with 154 additions and 75 deletions

View File

@ -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,8 +83,11 @@ commands:</para>
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
--enable-randpkt --enable-threads &amp;&amp;
make &amp;&amp;
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>
@ -94,14 +100,24 @@ capture program.</para>
<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 @@ using the menu options of the <command>ethereal</command>
<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 @@ Enable the Packet protocol by choosing <quote>Y</quote> in the
&ndash; <quote>Networking options</quote> &ndash; <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,76 +157,131 @@ certain classes of packets, it is more efficient to do it with
<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>

View File

@ -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">

View File

@ -22,8 +22,9 @@ who wrote what.</para>
<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

View File

@ -129,6 +129,9 @@ comprehensive information about building your own firewall.</para>
<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.

View File

@ -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&#243;n del n&#250;cleo"/>
</l:l10n>

View File

@ -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'">

View File

@ -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>