Changeset 894de226


Ignore:
Timestamp:
07/17/2007 06:36:24 PM (16 years ago)
Author:
Randy McMurchy <randy@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/inkscape-core-mods, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
d931c7f
Parents:
3fef5b2
Message:

Updated to Wireshark-0.99.6 (formerly named Ethereal)

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6912 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:
4 edited
1 moved

Legend:

Unmodified
Added
Removed

  • basicnet/netutils/netutils.xml

    r3fef5b2 r894de226  
    2727  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="whois.xml"/>
    2828  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bind-utils.xml"/>
    29   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ethereal.xml"/>
     29  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wireshark.xml"/>
    3030
    3131</chapter>

  • basicnet/netutils/wireshark.xml

    r3fef5b2 r894de226  
    55  %general-entities;
    66
    7   <!ENTITY ethereal-download-http "http://www.ethereal.com/distribution/ethereal-&ethereal-version;.tar.bz2">
    8   <!ENTITY ethereal-download-ftp  "ftp://ftp.ethereal.com/pub/ethereal/all-versions/ethereal-&ethereal-version;.tar.bz2">
    9   <!ENTITY ethereal-md5sum        "f9905b9d347acdc05af664a7553f7f76">
    10   <!ENTITY ethereal-size          "8.8 MB">
    11   <!ENTITY ethereal-buildsize     "331 MB">
    12   <!ENTITY ethereal-time          "5.4 SBU">
     7  <!ENTITY wireshark-download-http "http://www.wireshark.org/download/src/wireshark-&wireshark-version;.tar.bz2">
     8  <!ENTITY wireshark-download-ftp  "ftp://ftp.uni-kl.de/pub/wireshark/src/wireshark-&wireshark-version;.tar.bz2">
     9  <!ENTITY wireshark-md5sum        "e57a8c8b364c38df3da97e2ee9f0d0bc">
     10  <!ENTITY wireshark-size          "11.8 MB">
     11  <!ENTITY wireshark-buildsize     "449 MB">
     12  <!ENTITY wireshark-time          "6.4 SBU">
    1313]>
    1414
    15 <sect1 id="ethereal" xreflabel="Ethereal-&ethereal-version;">
    16   <?dbhtml filename="ethereal.html"?>
     15<sect1 id="wireshark" xreflabel="Wireshark-&wireshark-version;">
     16  <?dbhtml filename="wireshark.html"?>
    1717
    1818  <sect1info>
    … …  
    2121  </sect1info>
    2222
    23   <title>Ethereal-&ethereal-version;</title>
    24 
    25   <indexterm zone="ethereal">
    26     <primary sortas="a-Ethereal">Ethereal</primary>
     23  <title>Wireshark-&wireshark-version;</title>
     24
     25  <indexterm zone="wireshark">
     26    <primary sortas="a-Wireshark">Wireshark</primary>
    2727  </indexterm>
    2828
    2929  <sect2 role="package">
    30     <title>Introduction to Ethereal</title>
    31 
    32     <para>The <application>Ethereal</application> package contains a network
     30    <title>Introduction to Wireshark</title>
     31
     32    <para>The <application>Wireshark</application> package contains a network
    3333    protocol analyzer, also known as a <quote>sniffer</quote>. This is useful
    3434    for analyzing data captured <quote>off the wire</quote> from a live network
    3535    connection, or data read from a capture file.
    36     <application>Ethereal</application> provides both a graphical and TTY-mode
     36    <application>Wireshark</application> provides both a graphical and TTY-mode
    3737    front-end for examining captured network packets from over 500 protocols,
    3838    as well as the capability to read capture files from many other popular
    … …  
    4242    <itemizedlist spacing="compact">
    4343      <listitem>
    44         <para>Download (HTTP): <ulink url="&ethereal-download-http;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download (FTP): <ulink url="&ethereal-download-ftp;"/></para>
    48       </listitem>
    49       <listitem>
    50         <para>Download MD5 sum: &ethereal-md5sum;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Download size: &ethereal-size;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated disk space required: &ethereal-buildsize;</para>
    57       </listitem>
    58       <listitem>
    59         <para>Estimated build time: &ethereal-time;</para>
     44        <para>Download (HTTP): <ulink url="&wireshark-download-http;"/></para>
     45      </listitem>
     46      <listitem>
     47        <para>Download (FTP): <ulink url="&wireshark-download-ftp;"/></para>
     48      </listitem>
     49      <listitem>
     50        <para>Download MD5 sum: &wireshark-md5sum;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Download size: &wireshark-size;</para>
     54      </listitem>
     55      <listitem>
     56        <para>Estimated disk space required: &wireshark-buildsize;</para>
     57      </listitem>
     58      <listitem>
     59        <para>Estimated build time: &wireshark-time;</para>
    6060      </listitem>
    6161    </itemizedlist>
    … …  
    6565      <listitem>
    6666        <para>Additional Documentation: <ulink
    67         url="http://www.ethereal.com/docs/"/></para>
     67        url="http://www.wireshark.org/docs/"/></para>
    6868      </listitem>
    6969    </itemizedlist>
    … …  
    7272    of formats.</para>
    7373
    74     <bridgehead renderas="sect3">Ethereal dependencies</bridgehead>
     74    <bridgehead renderas="sect3">Wireshark dependencies</bridgehead>
    7575
    7676    <bridgehead renderas="sect4">Required</bridgehead>
    7777    <para role="required"><xref linkend="GLib"/> or <xref linkend="glib2"/>
    7878    (to build the TTY-mode front-end only)</para>
     79
     80    <para>Note that if you don't have <application>Gtk+</application>
     81    installed, you will need to pass <option>--disable-wireshark</option>
     82    to the <command>configure</command> command.</para>
    7983
    8084    <bridgehead renderas="sect4">Recommended</bridgehead>
    … …  
    111115
    112116    <para condition="html" role="usernotes">User Notes:
    113     <ulink url="&blfs-wiki;/ethereal"/></para>
    114 
    115   </sect2>
    116 
    117   <sect2 role="kernel" id="ethereal-kernel">
     117    <ulink url="&blfs-wiki;/wireshark"/></para>
     118
     119  </sect2>
     120
     121  <sect2 role="kernel" id="wireshark-kernel">
    118122    <title>Kernel Configuration</title>
    119123
    120124      <para>The kernel must have the Packet protocol enabled for
    121       <application>Ethereal</application> to capture live packets from the
     125      <application>Wireshark</application> to capture live packets from the
    122126      network. Enable the Packet protocol by choosing <quote>Y</quote> in the
    123127      <quote>Networking</quote> &ndash; <quote>Packet socket</quote>
    … …  
    126130      this parameter.</para>
    127131
    128       <indexterm zone="ethereal ethereal-kernel">
     132      <indexterm zone="wireshark wireshark-kernel">
    129133        <primary sortas="d-Capturing-network-packets">Capturing network
    130134        packets</primary>
    … …  
    134138
    135139  <sect2 role="installation">
    136     <title>Installation of Ethereal</title>
    137 
    138     <para>Install <application>Ethereal</application> by running the following
     140    <title>Installation of Wireshark</title>
     141
     142    <para>Install <application>Wireshark</application> by running the following
    139143    commands:</para>
    140144
    … …  
    149153
    150154<screen role="root"><userinput>make install &amp;&amp;
    151 install -v -m644 FAQ README{,.linux} doc/README.* doc/*.{pod,txt} \
    152                  /usr/share/ethereal &amp;&amp;
    153 install -v -m644 -D ethereal.desktop \
    154                     /usr/share/applications/ethereal.desktop &amp;&amp;
    155 install -v -m644 -D image/elogo3d48x48.png \
    156                     /usr/share/pixmaps/ethereal.png &amp;&amp;
    157 install -v -m755 -d /usr/share/pixmaps/ethereal &amp;&amp;
     155
     156install -v -m755 -d /usr/share/doc/wireshark-&wireshark-version; &amp;&amp;
     157install -v -m644    FAQ README{,.linux} doc/README.* doc/*.{pod,txt} \
     158                    /usr/share/doc/wireshark-&wireshark-version; &amp;&amp;
     159pushd /usr/share/doc/wireshark-&wireshark-version; &amp;&amp;
     160for FILENAME in ../../wireshark/*.html; do \
     161    ln -s -v $FILENAME .
     162done &amp;&amp;
     163popd &amp;&amp;
     164
     165install -v -m644 -D wireshark.desktop \
     166                    /usr/share/applications/wireshark.desktop &amp;&amp;
     167install -v -m644 -D image/wsicon48.png \
     168                    /usr/share/pixmaps/wireshark.png &amp;&amp;
     169install -v -m755 -d /usr/share/pixmaps/wireshark &amp;&amp;
    158170install -v -m644 image/*.{png,ico,xpm,bmp} \
    159                  /usr/share/pixmaps/ethereal</userinput></screen>
     171                 /usr/share/pixmaps/wireshark</userinput></screen>
    160172
    161173    <para>If you downloaded any of the documentation files from the page
    … …  
    163175    commands as the <systemitem class="username">root</systemitem> user:</para>
    164176
    165 <screen role="root"><userinput>install -v -m755 -d /usr/share/doc/ethereal-&ethereal-version; &amp;&amp;
    166 install -v -m644 <replaceable>&lt;Downloaded_Files&gt;</replaceable> /usr/share/doc/ethereal-&ethereal-version;</userinput></screen>
     177<screen role="root"><userinput>install -v -m644 <replaceable>&lt;Downloaded_Files&gt;</replaceable> /usr/share/doc/wireshark-&wireshark-version;</userinput></screen>
    167178
    168179  </sect2>
    … …  
    172183
    173184    <para><parameter>--enable-threads</parameter>: This parameter enables the
    174     use of threads in <command>ethereal</command>.</para>
    175 
    176     <para><option>--with-ssl</option>: This parameter enables the use of the
     185    use of threads in <command>wireshark</command>.</para>
     186
     187    <para><option>--with-ssl</option>: This parameter is required if you
     188    are linking Kerberos libraries into the build so that the
    177189    <application>OpenSSL</application>
    178     <filename class='libraryfile'>libcrypto</filename> library.</para>
     190    <filename class='libraryfile'>libcrypto</filename> library is found.</para>
    179191
    180192  </sect2>
    181193
    182194  <sect2 role="configuration">
    183     <title>Configuring Ethereal</title>
    184 
    185     <sect3 id="ethereal-config">
     195    <title>Configuring Wireshark</title>
     196
     197    <sect3 id="wireshark-config">
    186198      <title>Config Files</title>
    187199
    188       <para><filename>/etc/ethereal.conf</filename> and
    189       <filename>~/.ethereal/preferences</filename></para>
    190 
    191       <indexterm zone="ethereal ethereal-config">
    192         <primary sortas="e-AA.ethereal-preferences">~/.ethereal/preferences</primary>
     200      <para><filename>/etc/wireshark.conf</filename> and
     201      <filename>~/.wireshark/*</filename></para>
     202
     203      <indexterm zone="wireshark wireshark-config">
     204        <primary sortas="e-AA.wireshark-star">~/.wireshark/*</primary>
    193205      </indexterm>
    194206
    195       <indexterm zone="ethereal ethereal-config">
    196         <primary sortas="e-etc-ethereal.conf">/etc/ethereal.conf</primary>
     207      <indexterm zone="wireshark wireshark-config">
     208        <primary sortas="e-etc-wireshark.conf">/etc/wireshark.conf</primary>
    197209      </indexterm>
    198210
    … …  
    204216      <para>Though the default configuration parameters are very sane,
    205217      reference the configuration section of the
    206       <ulink url="http://www.ethereal.com/docs/user-guide/">Ethereal User's
     218      <ulink url="http://www.wireshark.org/docs/wsug_html/">Wireshark User's
    207219      Guide</ulink> for configuration information. Most of
    208       <application>Ethereal</application>'s configuration can be accomplished
    209       using the menu options of the <command>ethereal</command>
     220      <application>Wireshark</application>'s configuration can be accomplished
     221      using the menu options of the <command>wireshark</command>
    210222      graphical interface.</para>
    211223
    … …  
    214226        them out with <xref linkend="iptables"/>. If you want to exclude
    215227        certain classes of packets, it is more efficient to do it with
    216         <application>iptables</application> than
    217         <application>Ethereal</application>.</para>
     228        <application>iptables</application> than it is with
     229        <application>Wireshark</application>.</para>
    218230      </note>
    219231
    … …  
    231243
    232244      <seglistitem>
    233         <seg>capinfos, dftest, editcap, ethereal, idl2eth, mergecap, randpkt,
    234         tethereal and text2pcap</seg>
    235         <seg>libethereal.so, libwiretap.so and numerous dissector plugin
     245        <seg>capinfos, dftest, dumpcap, editcap, idl2wrs, mergecap, randpkt,
     246        text2pcap, tshark and wireshark</seg>
     247        <seg>libwireshark.so, libwiretap.so and numerous dissector plugin
    236248        modules</seg>
    237         <seg>/usr/lib/ethereal, /usr/share/ethereal and
    238         /usr/share/pixmaps/ethereal</seg>
     249        <seg>/usr/lib/wireshark, /usr/share/doc/wireshark-&wireshark-version;,
     250        /usr/share/pixmaps/wireshark and /usr/share/wireshark</seg>
    239251      </seglistitem>
    240252    </segmentedlist>
    … …  
    250262          <para>reads a saved capture file and returns any or all of several
    251263          statistics about that file. It is able to detect and read any capture
    252           supported by the <application>Ethereal</application> package.</para>
    253           <indexterm zone="ethereal capinfos">
     264          supported by the <application>Wireshark</application> package.</para>
     265          <indexterm zone="wireshark capinfos">
    254266            <primary sortas="b-capinfos">capinfos</primary>
    255267          </indexterm>
    … …  
    261273        <listitem>
    262274          <para>is a display-filter-compiler test program.</para>
    263           <indexterm zone="ethereal dftest">
     275          <indexterm zone="wireshark dftest">
    264276            <primary sortas="b-dftest">dftest</primary>
     277          </indexterm>
     278        </listitem>
     279      </varlistentry>
     280
     281      <varlistentry id="dumpcap">
     282        <term><command>dumpcap</command></term>
     283        <listitem>
     284          <para>is a network traffic dump tool. It lets you capture packet data
     285          from a live network and write the packets to a file.</para>
     286          <indexterm zone="wireshark dumpcap">
     287            <primary sortas="b-dumpcap">dumpcap</primary>
    265288          </indexterm>
    266289        </listitem>
    … …  
    273296          how to read <application>libpcap</application> capture files,
    274297          including those of <command>tcpdump</command>,
    275           <application>Ethereal</application> and other tools that write
     298          <application>Wireshark</application> and other tools that write
    276299          captures in that format.</para>
    277           <indexterm zone="ethereal editcap">
     300          <indexterm zone="wireshark editcap">
    278301            <primary sortas="b-editcap">editcap</primary>
    279302          </indexterm>
    … …  
    281304      </varlistentry>
    282305
    283       <varlistentry id="ethereal-prog">
    284         <term><command>ethereal</command></term>
     306      <varlistentry id="idl2wrs">
     307        <term><command>idl2wrs</command></term>
     308        <listitem>
     309          <para>takes a user specified CORBA
     310          IDL file and generates <quote>C</quote> source code that
     311          can be used to create an <application>Wireshark</application>
     312          plugin.</para>
     313          <indexterm zone="wireshark idl2wrs">
     314            <primary sortas="b-idl2wrs">idl2wrs</primary>
     315          </indexterm>
     316        </listitem>
     317      </varlistentry>
     318
     319      <varlistentry id="mergecap">
     320        <term><command>mergecap</command></term>
     321        <listitem>
     322          <para>combines multiple saved capture files into a single output
     323          file.</para>
     324          <indexterm zone="wireshark mergecap">
     325            <primary sortas="b-mergecap">mergecap</primary>
     326          </indexterm>
     327        </listitem>
     328      </varlistentry>
     329
     330      <varlistentry id="randpkt">
     331        <term><command>randpkt</command></term>
     332        <listitem>
     333          <para>creates random-packet capture files.</para>
     334          <indexterm zone="wireshark randpkt">
     335            <primary sortas="b-randpkt">randpkt</primary>
     336          </indexterm>
     337        </listitem>
     338      </varlistentry>
     339
     340      <varlistentry id="text2pcap">
     341        <term><command>text2pcap</command></term>
     342        <listitem>
     343          <para>reads in an ASCII hex dump and writes the
     344          data described into a <application>libpcap</application>-style
     345          capture file.</para>
     346          <indexterm zone="wireshark text2pcap">
     347            <primary sortas="b-text2pcap">text2pcap</primary>
     348          </indexterm>
     349        </listitem>
     350      </varlistentry>
     351
     352      <varlistentry id="tshark">
     353        <term><command>tshark</command></term>
     354        <listitem>
     355          <para>is a TTY-mode network protocol analyzer. It lets you capture
     356          packet data from a live network or read packets from a
     357          previously saved capture file.</para>
     358          <indexterm zone="wireshark tshark">
     359            <primary sortas="b-tshark">tshark</primary>
     360          </indexterm>
     361        </listitem>
     362      </varlistentry>
     363
     364      <varlistentry id="wireshark-prog">
     365        <term><command>wireshark</command></term>
    285366        <listitem>
    286367          <para>is a GUI network protocol analyzer. It lets you interactively
    287368          browse packet data from a live network or from a previously
    288369          saved capture file.</para>
    289           <indexterm zone="ethereal ethereal-prog">
    290             <primary sortas="b-ethereal">ethereal</primary>
    291           </indexterm>
    292         </listitem>
    293       </varlistentry>
    294 
    295       <varlistentry id="idl2eth">
    296         <term><command>idl2eth</command></term>
    297         <listitem>
    298           <para>takes a user specified CORBA
    299           IDL file and generates <quote>C</quote> source code that
    300           can be used to create an <application>Ethereal</application>
    301           plugin.</para>
    302           <indexterm zone="ethereal idl2eth">
    303             <primary sortas="b-idl2eth">idl2eth</primary>
    304           </indexterm>
    305         </listitem>
    306       </varlistentry>
    307 
    308       <varlistentry id="mergecap">
    309         <term><command>mergecap</command></term>
    310         <listitem>
    311           <para>combines multiple saved capture files into a single output
    312           file.</para>
    313           <indexterm zone="ethereal mergecap">
    314             <primary sortas="b-mergecap">mergecap</primary>
    315           </indexterm>
    316         </listitem>
    317       </varlistentry>
    318 
    319       <varlistentry id="randpkt">
    320         <term><command>randpkt</command></term>
    321         <listitem>
    322           <para>creates random-packet capture files.</para>
    323           <indexterm zone="ethereal randpkt">
    324             <primary sortas="b-randpkt">randpkt</primary>
    325           </indexterm>
    326         </listitem>
    327       </varlistentry>
    328 
    329       <varlistentry id="tethereal">
    330         <term><command>tethereal</command></term>
    331         <listitem>
    332           <para>is a TTY-mode network protocol analyzer. It lets you capture
    333           packet data from a live network or read packets from a
    334           previously saved capture file.</para>
    335           <indexterm zone="ethereal tethereal">
    336             <primary sortas="b-tethereal">tethereal</primary>
    337           </indexterm>
    338         </listitem>
    339       </varlistentry>
    340 
    341       <varlistentry id="text2pcap">
    342         <term><command>text2pcap</command></term>
    343         <listitem>
    344           <para>reads in an ASCII hex dump and writes the
    345           data described into a <application>libpcap</application>-style
    346           capture file.</para>
    347           <indexterm zone="ethereal text2pcap">
    348             <primary sortas="b-text2pcap">text2pcap</primary>
    349           </indexterm>
    350         </listitem>
    351       </varlistentry>
    352 
    353       <varlistentry id="libethereal">
    354         <term><filename class='libraryfile'>libethereal.so</filename></term>
     370          <indexterm zone="wireshark wireshark-prog">
     371            <primary sortas="b-wireshark">wireshark</primary>
     372          </indexterm>
     373        </listitem>
     374      </varlistentry>
     375
     376      <varlistentry id="libwireshark">
     377        <term><filename class='libraryfile'>libwireshark.so</filename></term>
    355378        <listitem>
    356379          <para>contains functions used by the
    357           <application>Ethereal</application> programs to perform filtering and
     380          <application>Wireshark</application> programs to perform filtering and
    358381          packet capturing.</para>
    359           <indexterm zone="ethereal libethereal">
    360             <primary sortas="c-libethereal">libethereal.so</primary>
     382          <indexterm zone="wireshark libwireshark">
     383            <primary sortas="c-libwireshark">libwireshark.so</primary>
    361384          </indexterm>
    362385        </listitem>
    … …  
    371394          see the <filename>README</filename> file in the source
    372395          <filename class='directory'>wiretap</filename> directory.</para>
    373           <indexterm zone="ethereal libwiretap">
     396          <indexterm zone="wireshark libwiretap">
    374397            <primary sortas="c-libwiretap">libwiretap.so</primary>
    375398          </indexterm>

  • general.ent

    r3fef5b2 r894de226  
    336336<!ENTITY whois-version                "4.7.21">
    337337<!ENTITY bind-version                 "9.3.3">
    338 <!ENTITY ethereal-version             "0.99.0">
     338<!ENTITY wireshark-version            "0.99.6">
    339339
    340340<!-- Chapter 20 -->

  • introduction/welcome/changelog.xml

    r3fef5b2 r894de226  
    4646      <itemizedlist>
    4747        <listitem>
     48          <para>[randy] - Updated to Wireshark-0.99.6 (formerly
     49          named Ethereal).</para>
     50        </listitem>
     51        <listitem>
    4852          <para>[randy] - Updated to libpcap-0.9.6.</para>
    4953        </listitem>

  • introduction/welcome/credits.xml

    r3fef5b2 r894de226  
    267267
    268268      <listitem>
    269         <para>ALSA Tools, Apache Ant, cairo, Cyrus-SASL, D-BUS, DejaGnu,
     269        <para>ALSA Tools, Apache Ant, cairo, Cyrus-SASL, D-BUS,
     270        D-Bus Bindings, DejaGnu,
    270271        desktop-file-utils, DocBook DSSSL Stylesheets, DocBook-utils,
    271         dvd+rw-tools, Ethereal, Evince, Evolution Data Server, Exim (many
     272        dvd+rw-tools, Evince, Evolution Data Server, Exim (many
    272273        additions), Expect, FOP, FreeTTS, FriBidi, GC, GCC (rewrite), GMime,
    273274        gnome-audio, gnome-backgrounds, gnome-menus, gnome-mount,
    … …  
    283284        pilot-link, Poppler, PyXML, Samba 3 (many additions), SANE (original
    284285        instructions by Alex Kloss), Shadow (rewrite), SLIB, Sound Juicer,
    285         Stunnel, Sysstat, system-tools-backends, Totem, unixODBC and usbutils:
     286        Stunnel, Subversion Client (many additions), Sysstat,
     287        system-tools-backends, Totem, unixODBC, Wireshark and usbutils:
    286288        <emphasis>Randy McMurchy</emphasis></para>
    287289      </listitem>
Note: See TracChangeset for help on using the changeset viewer.