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-ðereal-version;.tar.bz2";> - <!ENTITY ethereal-download-ftp "ftp://ftp.ethereal.com/pub/ethereal/all-versions/ethereal-ðereal-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-ðereal-version;"> - <?dbhtml filename="ethereal.html"?> - - <sect1info> - <othername>$LastChangedBy$</othername> - <date>$Date$</date> - </sect1info> - - <title>Ethereal-ðereal-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="ðereal-download-http;"/></para> - </listitem> - <listitem> - <para>Download (FTP): <ulink url="ðereal-download-ftp;"/></para> - </listitem> - <listitem> - <para>Download MD5 sum: ðereal-md5sum;</para> - </listitem> - <listitem> - <para>Download size: ðereal-size;</para> - </listitem> - <listitem> - <para>Estimated disk space required: ðereal-buildsize;</para> - </listitem> - <listitem> - <para>Estimated build time: ðereal-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-ðereal-version; && -install -v -m644 <replaceable><Downloaded_Files></replaceable> /usr/share/doc/ethereal-ðereal-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> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
