r6912 - in trunk/BOOK: . basicnet/netutils introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Tue Jul 17 11:36:25 PDT 2007


Author: randy
Date: 2007-07-17 12:36:24 -0600 (Tue, 17 Jul 2007)
New Revision: 6912

Added:
   trunk/BOOK/basicnet/netutils/wireshark.xml
Removed:
   trunk/BOOK/basicnet/netutils/ethereal.xml
Modified:
   trunk/BOOK/basicnet/netutils/netutils.xml
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
Log:
Updated to Wireshark-0.99.6 (formerly named Ethereal)

Deleted: trunk/BOOK/basicnet/netutils/ethereal.xml
===================================================================
--- trunk/BOOK/basicnet/netutils/ethereal.xml	2007-07-17 15:11:36 UTC (rev 6911)
+++ trunk/BOOK/basicnet/netutils/ethereal.xml	2007-07-17 18:36:24 UTC (rev 6912)
@@ -1,383 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../../general.ent">
-  %general-entities;
-
-  <!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        "f9905b9d347acdc05af664a7553f7f76">
-  <!ENTITY ethereal-size          "8.8 MB">
-  <!ENTITY ethereal-buildsize     "331 MB">
-  <!ENTITY ethereal-time          "5.4 SBU">
-]>
-
-<sect1 id="ethereal" xreflabel="Ethereal-&ethereal-version;">
-  <?dbhtml filename="ethereal.html"?>
-
-  <sect1info>
-    <othername>$LastChangedBy$</othername>
-    <date>$Date$</date>
-  </sect1info>
-
-  <title>Ethereal-&ethereal-version;</title>
-
-  <indexterm zone="ethereal">
-    <primary sortas="a-Ethereal">Ethereal</primary>
-  </indexterm>
-
-  <sect2 role="package">
-    <title>Introduction to Ethereal</title>
-
-    <para>The <application>Ethereal</application> package contains a network
-    protocol analyzer, also known as a <quote>sniffer</quote>. This is useful
-    for analyzing data captured <quote>off the wire</quote> from a live network
-    connection, or data read from a capture file.
-    <application>Ethereal</application> provides both a graphical and TTY-mode
-    front-end for examining captured network packets from over 500 protocols,
-    as well as the capability to read capture files from many other popular
-    network analyzers.</para>
-
-    <bridgehead renderas="sect3">Package Information</bridgehead>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>Download (HTTP): <ulink url="&ethereal-download-http;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download (FTP): <ulink url="&ethereal-download-ftp;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download MD5 sum: &ethereal-md5sum;</para>
-      </listitem>
-      <listitem>
-        <para>Download size: &ethereal-size;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated disk space required: &ethereal-buildsize;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated build time: &ethereal-time;</para>
-      </listitem>
-    </itemizedlist>
-
-    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>Additional Documentation: <ulink
-        url="http://www.ethereal.com/docs/"/></para>
-      </listitem>
-    </itemizedlist>
-
-    <para>From this page you can download many different docs in a variety
-    of formats.</para>
-
-    <bridgehead renderas="sect3">Ethereal dependencies</bridgehead>
-
-    <bridgehead renderas="sect4">Required</bridgehead>
-    <para role="required"><xref linkend="GLib"/> or <xref linkend="glib2"/>
-    (to build the TTY-mode front-end only)</para>
-
-    <bridgehead renderas="sect4">Recommended</bridgehead>
-    <para role="recommended"><xref linkend="libpcap"/>
-    (required to capture data)</para>
-
-    <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="pkgconfig"/>,
-    <xref linkend="GTK"/> or <xref linkend="gtk2"/>
-    (to build the GUI front-end),
-    <xref linkend="openssl"/>,
-    <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
-    <xref linkend="python"/>,
-    <xref linkend="pcre"/>,
-    <ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink>
-    (which needs <ulink
-    url="http://www.gnupg.org/download/index.html#libgpg-error">libgpg-error</ulink>
-    then <ulink
-    url="http://www.gnupg.org/download/index.html#libgcrypt">libgcrypt</ulink>),
-    <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
-    <ulink url="http://www.gnu.org/software/adns/adns.html">adns</ulink>, and
-    <ulink url="http://www.lua.org/">Lua</ulink></para>
-
-    <!-- Though configure looks for all these, and the developers I'm
-         sure use them, the doc sources are not included in the release
-         tarball (they are in SVN, though)
-    <bridgehead renderas="sect4">Optional (to build additional
-    documentation)</bridgehead>
-    <para role="optional"><xref linkend="doxygen"/>,
-    <xref linkend="libxml"/>,
-    <xref linkend="libxslt"/>, and
-    <xref linkend="fop"/></para>
-    -->
-
-    <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/ethereal"/></para>
-
-  </sect2>
-
-  <sect2 role="kernel" 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
-      <quote>Networking</quote> – <quote>Packet socket</quote>
-      configuration parameter. Alternatively, build the
-      <filename>af_packet.ko</filename> 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>
-
-  </sect2>
-
-  <sect2 role="installation">
-    <title>Installation of Ethereal</title>
-
-    <para>Install <application>Ethereal</application> by running the following
-    commands:</para>
-
-<screen><userinput>./configure --prefix=/usr \
-            --sysconfdir=/etc \
-            --enable-threads &&
-make</userinput></screen>
-
-    <para>This package does not come with a test suite.</para>
-
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
-
-<screen role="root"><userinput>make install &&
-install -v -m644 FAQ README{,.linux} doc/README.* doc/*.{pod,txt} \
-                 /usr/share/ethereal &&
-install -v -m644 -D ethereal.desktop \
-                    /usr/share/applications/ethereal.desktop &&
-install -v -m644 -D image/elogo3d48x48.png \
-                    /usr/share/pixmaps/ethereal.png &&
-install -v -m755 -d /usr/share/pixmaps/ethereal &&
-install -v -m644 image/*.{png,ico,xpm,bmp} \
-                 /usr/share/pixmaps/ethereal</userinput></screen>
-
-    <para>If you downloaded any of the documentation files from the page
-    listed in the 'Additional Downloads', install them by issuing the following
-    commands as the <systemitem class="username">root</systemitem> user:</para>
-
-<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/ethereal-&ethereal-version; &&
-install -v -m644 <replaceable><Downloaded_Files></replaceable> /usr/share/doc/ethereal-&ethereal-version;</userinput></screen>
-
-  </sect2>
-
-  <sect2 role="commands">
-    <title>Command Explanations</title>
-
-    <para><parameter>--enable-threads</parameter>: 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>OpenSSL</application>
-    <filename class='libraryfile'>libcrypto</filename> library.</para>
-
-  </sect2>
-
-  <sect2 role="configuration">
-    <title>Configuring Ethereal</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>
-
-      <para>Though the default configuration parameters are very sane,
-      reference the configuration section of the
-      <ulink url="http://www.ethereal.com/docs/user-guide/">Ethereal User's
-      Guide</ulink> for configuration information. Most of
-      <application>Ethereal</application>'s configuration can be accomplished
-      using the menu options of the <command>ethereal</command>
-      graphical interface.</para>
-
-      <note>
-        <para>If you want to look at packets, make sure you don't filter
-        them out with <xref linkend="iptables"/>. If you want to exclude
-        certain classes of packets, it is more efficient to do it with
-        <application>iptables</application> than
-        <application>Ethereal</application>.</para>
-      </note>
-
-    </sect3>
-
-  </sect2>
-
-  <sect2 role="content">
-    <title>Contents</title>
-
-    <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Libraries</segtitle>
-      <segtitle>Installed Directories</segtitle>
-
-      <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, /usr/share/ethereal and
-        /usr/share/pixmaps/ethereal</seg>
-      </seglistitem>
-    </segmentedlist>
-
-    <variablelist>
-      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
-      <?dbfo list-presentation="list"?>
-      <?dbhtml list-presentation="table"?>
-
-      <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>
-
-      <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>
-
-      <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>
-
-      <varlistentry id="ethereal-prog">
-        <term><command>ethereal</command></term>
-        <listitem>
-          <para>is a GUI 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>
-
-      <varlistentry id="idl2eth">
-        <term><command>idl2eth</command></term>
-        <listitem>
-          <para>takes a user specified CORBA
-          IDL 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>
-
-      <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>
-
-      <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>
-
-      <varlistentry id="tethereal">
-        <term><command>tethereal</command></term>
-        <listitem>
-          <para>is a TTY-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>
-
-      <varlistentry id="text2pcap">
-        <term><command>text2pcap</command></term>
-        <listitem>
-          <para>reads in an ASCII 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/basicnet/netutils/netutils.xml
===================================================================
--- trunk/BOOK/basicnet/netutils/netutils.xml	2007-07-17 15:11:36 UTC (rev 6911)
+++ trunk/BOOK/basicnet/netutils/netutils.xml	2007-07-17 18:36:24 UTC (rev 6912)
@@ -26,6 +26,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="nmap.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="whois.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bind-utils.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ethereal.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wireshark.xml"/>
 
 </chapter>

Copied: trunk/BOOK/basicnet/netutils/wireshark.xml (from rev 6906, trunk/BOOK/basicnet/netutils/ethereal.xml)
===================================================================
--- trunk/BOOK/basicnet/netutils/wireshark.xml	                        (rev 0)
+++ trunk/BOOK/basicnet/netutils/wireshark.xml	2007-07-17 18:36:24 UTC (rev 6912)
@@ -0,0 +1,406 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY wireshark-download-http "http://www.wireshark.org/download/src/wireshark-&wireshark-version;.tar.bz2">
+  <!ENTITY wireshark-download-ftp  "ftp://ftp.uni-kl.de/pub/wireshark/src/wireshark-&wireshark-version;.tar.bz2">
+  <!ENTITY wireshark-md5sum        "e57a8c8b364c38df3da97e2ee9f0d0bc">
+  <!ENTITY wireshark-size          "11.8 MB">
+  <!ENTITY wireshark-buildsize     "449 MB">
+  <!ENTITY wireshark-time          "6.4 SBU">
+]>
+
+<sect1 id="wireshark" xreflabel="Wireshark-&wireshark-version;">
+  <?dbhtml filename="wireshark.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Wireshark-&wireshark-version;</title>
+
+  <indexterm zone="wireshark">
+    <primary sortas="a-Wireshark">Wireshark</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Wireshark</title>
+
+    <para>The <application>Wireshark</application> package contains a network
+    protocol analyzer, also known as a <quote>sniffer</quote>. This is useful
+    for analyzing data captured <quote>off the wire</quote> from a live network
+    connection, or data read from a capture file.
+    <application>Wireshark</application> provides both a graphical and TTY-mode
+    front-end for examining captured network packets from over 500 protocols,
+    as well as the capability to read capture files from many other popular
+    network analyzers.</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&wireshark-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&wireshark-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &wireshark-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &wireshark-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &wireshark-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &wireshark-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Additional Documentation: <ulink
+        url="http://www.wireshark.org/docs/"/></para>
+      </listitem>
+    </itemizedlist>
+
+    <para>From this page you can download many different docs in a variety
+    of formats.</para>
+
+    <bridgehead renderas="sect3">Wireshark dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required"><xref linkend="GLib"/> or <xref linkend="glib2"/>
+    (to build the TTY-mode front-end only)</para>
+
+    <para>Note that if you don't have <application>Gtk+</application>
+    installed, you will need to pass <option>--disable-wireshark</option>
+    to the <command>configure</command> command.</para>
+
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended"><xref linkend="libpcap"/>
+    (required to capture data)</para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional"><xref linkend="pkgconfig"/>,
+    <xref linkend="GTK"/> or <xref linkend="gtk2"/>
+    (to build the GUI front-end),
+    <xref linkend="openssl"/>,
+    <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
+    <xref linkend="python"/>,
+    <xref linkend="pcre"/>,
+    <ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink>
+    (which needs <ulink
+    url="http://www.gnupg.org/download/index.html#libgpg-error">libgpg-error</ulink>
+    then <ulink
+    url="http://www.gnupg.org/download/index.html#libgcrypt">libgcrypt</ulink>),
+    <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
+    <ulink url="http://www.gnu.org/software/adns/adns.html">adns</ulink>, and
+    <ulink url="http://www.lua.org/">Lua</ulink></para>
+
+    <!-- Though configure looks for all these, and the developers I'm
+         sure use them, the doc sources are not included in the release
+         tarball (they are in SVN, though)
+    <bridgehead renderas="sect4">Optional (to build additional
+    documentation)</bridgehead>
+    <para role="optional"><xref linkend="doxygen"/>,
+    <xref linkend="libxml"/>,
+    <xref linkend="libxslt"/>, and
+    <xref linkend="fop"/></para>
+    -->
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/wireshark"/></para>
+
+  </sect2>
+
+  <sect2 role="kernel" id="wireshark-kernel">
+    <title>Kernel Configuration</title>
+
+      <para>The kernel must have the Packet protocol enabled for
+      <application>Wireshark</application> to capture live packets from the
+      network. Enable the Packet protocol by choosing <quote>Y</quote> in the
+      <quote>Networking</quote> – <quote>Packet socket</quote>
+      configuration parameter. Alternatively, build the
+      <filename>af_packet.ko</filename> module by choosing <quote>M</quote> in
+      this parameter.</para>
+
+      <indexterm zone="wireshark wireshark-kernel">
+        <primary sortas="d-Capturing-network-packets">Capturing network
+        packets</primary>
+      </indexterm>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Wireshark</title>
+
+    <para>Install <application>Wireshark</application> by running the following
+    commands:</para>
+
+<screen><userinput>./configure --prefix=/usr \
+            --sysconfdir=/etc \
+            --enable-threads &&
+make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+
+install -v -m755 -d /usr/share/doc/wireshark-&wireshark-version; &&
+install -v -m644    FAQ README{,.linux} doc/README.* doc/*.{pod,txt} \
+                    /usr/share/doc/wireshark-&wireshark-version; &&
+pushd /usr/share/doc/wireshark-&wireshark-version; &&
+for FILENAME in ../../wireshark/*.html; do \
+    ln -s -v $FILENAME .
+done &&
+popd &&
+
+install -v -m644 -D wireshark.desktop \
+                    /usr/share/applications/wireshark.desktop &&
+install -v -m644 -D image/wsicon48.png \
+                    /usr/share/pixmaps/wireshark.png &&
+install -v -m755 -d /usr/share/pixmaps/wireshark &&
+install -v -m644 image/*.{png,ico,xpm,bmp} \
+                 /usr/share/pixmaps/wireshark</userinput></screen>
+
+    <para>If you downloaded any of the documentation files from the page
+    listed in the 'Additional Downloads', install them by issuing the following
+    commands as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>install -v -m644 <replaceable><Downloaded_Files></replaceable> /usr/share/doc/wireshark-&wireshark-version;</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><parameter>--enable-threads</parameter>: This parameter enables the
+    use of threads in <command>wireshark</command>.</para>
+
+    <para><option>--with-ssl</option>: This parameter is required if you
+    are linking Kerberos libraries into the build so that the
+    <application>OpenSSL</application>
+    <filename class='libraryfile'>libcrypto</filename> library is found.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring Wireshark</title>
+
+    <sect3 id="wireshark-config">
+      <title>Config Files</title>
+
+      <para><filename>/etc/wireshark.conf</filename> and
+      <filename>~/.wireshark/*</filename></para>
+
+      <indexterm zone="wireshark wireshark-config">
+        <primary sortas="e-AA.wireshark-star">~/.wireshark/*</primary>
+      </indexterm>
+
+      <indexterm zone="wireshark wireshark-config">
+        <primary sortas="e-etc-wireshark.conf">/etc/wireshark.conf</primary>
+      </indexterm>
+
+    </sect3>
+
+    <sect3>
+      <title>Configuration Information</title>
+
+      <para>Though the default configuration parameters are very sane,
+      reference the configuration section of the
+      <ulink url="http://www.wireshark.org/docs/wsug_html/">Wireshark User's
+      Guide</ulink> for configuration information. Most of
+      <application>Wireshark</application>'s configuration can be accomplished
+      using the menu options of the <command>wireshark</command>
+      graphical interface.</para>
+
+      <note>
+        <para>If you want to look at packets, make sure you don't filter
+        them out with <xref linkend="iptables"/>. If you want to exclude
+        certain classes of packets, it is more efficient to do it with
+        <application>iptables</application> than it is with
+        <application>Wireshark</application>.</para>
+      </note>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>capinfos, dftest, dumpcap, editcap, idl2wrs, mergecap, randpkt,
+        text2pcap, tshark and wireshark</seg>
+        <seg>libwireshark.so, libwiretap.so and numerous dissector plugin
+        modules</seg>
+        <seg>/usr/lib/wireshark, /usr/share/doc/wireshark-&wireshark-version;,
+        /usr/share/pixmaps/wireshark and /usr/share/wireshark</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <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>Wireshark</application> package.</para>
+          <indexterm zone="wireshark capinfos">
+            <primary sortas="b-capinfos">capinfos</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="dftest">
+        <term><command>dftest</command></term>
+        <listitem>
+          <para>is a display-filter-compiler test program.</para>
+          <indexterm zone="wireshark dftest">
+            <primary sortas="b-dftest">dftest</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="dumpcap">
+        <term><command>dumpcap</command></term>
+        <listitem>
+          <para>is a network traffic dump tool. It lets you capture packet data
+          from a live network and write the packets to a file.</para>
+          <indexterm zone="wireshark dumpcap">
+            <primary sortas="b-dumpcap">dumpcap</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <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>Wireshark</application> and other tools that write
+          captures in that format.</para>
+          <indexterm zone="wireshark editcap">
+            <primary sortas="b-editcap">editcap</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="idl2wrs">
+        <term><command>idl2wrs</command></term>
+        <listitem>
+          <para>takes a user specified CORBA
+          IDL file and generates <quote>C</quote> source code that
+          can be used to create an <application>Wireshark</application>
+          plugin.</para>
+          <indexterm zone="wireshark idl2wrs">
+            <primary sortas="b-idl2wrs">idl2wrs</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="mergecap">
+        <term><command>mergecap</command></term>
+        <listitem>
+          <para>combines multiple saved capture files into a single output
+          file.</para>
+          <indexterm zone="wireshark mergecap">
+            <primary sortas="b-mergecap">mergecap</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="randpkt">
+        <term><command>randpkt</command></term>
+        <listitem>
+          <para>creates random-packet capture files.</para>
+          <indexterm zone="wireshark randpkt">
+            <primary sortas="b-randpkt">randpkt</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="text2pcap">
+        <term><command>text2pcap</command></term>
+        <listitem>
+          <para>reads in an ASCII hex dump and writes the
+          data described into a <application>libpcap</application>-style
+          capture file.</para>
+          <indexterm zone="wireshark text2pcap">
+            <primary sortas="b-text2pcap">text2pcap</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="tshark">
+        <term><command>tshark</command></term>
+        <listitem>
+          <para>is a TTY-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="wireshark tshark">
+            <primary sortas="b-tshark">tshark</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="wireshark-prog">
+        <term><command>wireshark</command></term>
+        <listitem>
+          <para>is a GUI network protocol analyzer. It lets you interactively
+          browse packet data from a live network or from a previously
+          saved capture file.</para>
+          <indexterm zone="wireshark wireshark-prog">
+            <primary sortas="b-wireshark">wireshark</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libwireshark">
+        <term><filename class='libraryfile'>libwireshark.so</filename></term>
+        <listitem>
+          <para>contains functions used by the
+          <application>Wireshark</application> programs to perform filtering and
+          packet capturing.</para>
+          <indexterm zone="wireshark libwireshark">
+            <primary sortas="c-libwireshark">libwireshark.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="wireshark libwiretap">
+            <primary sortas="c-libwiretap">libwiretap.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/basicnet/netutils/wireshark.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2007-07-17 15:11:36 UTC (rev 6911)
+++ trunk/BOOK/general.ent	2007-07-17 18:36:24 UTC (rev 6912)
@@ -335,7 +335,7 @@
 <!ENTITY nmap-version                 "4.03">
 <!ENTITY whois-version                "4.7.21">
 <!ENTITY bind-version                 "9.3.3">
-<!ENTITY ethereal-version             "0.99.0">
+<!ENTITY wireshark-version            "0.99.6">
 
 <!-- Chapter 20 -->
 <!ENTITY mailx-version                "12.2">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2007-07-17 15:11:36 UTC (rev 6911)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2007-07-17 18:36:24 UTC (rev 6912)
@@ -45,6 +45,10 @@
       <para>July 17th, 2007</para>
       <itemizedlist>
         <listitem>
+          <para>[randy] - Updated to Wireshark-0.99.6 (formerly
+          named Ethereal).</para>
+        </listitem>
+        <listitem>
           <para>[randy] - Updated to libpcap-0.9.6.</para>
         </listitem>
         <listitem>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2007-07-17 15:11:36 UTC (rev 6911)
+++ trunk/BOOK/introduction/welcome/credits.xml	2007-07-17 18:36:24 UTC (rev 6912)
@@ -266,9 +266,10 @@
       </listitem>
 
       <listitem>
-        <para>ALSA Tools, Apache Ant, cairo, Cyrus-SASL, D-BUS, DejaGnu,
+        <para>ALSA Tools, Apache Ant, cairo, Cyrus-SASL, D-BUS,
+        D-Bus Bindings, DejaGnu,
         desktop-file-utils, DocBook DSSSL Stylesheets, DocBook-utils,
-        dvd+rw-tools, Ethereal, Evince, Evolution Data Server, Exim (many
+        dvd+rw-tools, Evince, Evolution Data Server, Exim (many
         additions), Expect, FOP, FreeTTS, FriBidi, GC, GCC (rewrite), GMime,
         gnome-audio, gnome-backgrounds, gnome-menus, gnome-mount,
         gnome-screensaver, gnome-volume-manager, GNOME Doc Utils,
@@ -282,7 +283,8 @@
         (extensive overhaul), NSS, Other Programming Tools, PDL, Perl Modules,
         pilot-link, Poppler, PyXML, Samba 3 (many additions), SANE (original
         instructions by Alex Kloss), Shadow (rewrite), SLIB, Sound Juicer,
-        Stunnel, Sysstat, system-tools-backends, Totem, unixODBC and usbutils:
+        Stunnel, Subversion Client (many additions), Sysstat,
+        system-tools-backends, Totem, unixODBC, Wireshark and usbutils:
         <emphasis>Randy McMurchy</emphasis></para>
       </listitem>
 




More information about the blfs-book mailing list