Further cleanup of Wireshark User Guide
[obnox/wireshark/wip.git] / docbook / wsug_src / WSUG_app_tools.xml
index 8fdb6abd5de633d439f905bdf3905c3e15930117..8c0d8d0e21fd781ebc22f151aff4fe6b60bc2603 100644 (file)
@@ -19,7 +19,7 @@
        with Wireshark</title>
     <para>
       There are occasions when you want to capture packets using 
-      <command>tcpdump</command> rather than <command>ethereal</command>, 
+      <command>tcpdump</command> rather than <command>wireshark</command>, 
       especially when you want to do a remote capture and do not want the 
       network load associated with running Wireshark remotely (not to 
       mention all the X traffic polluting your capture).
@@ -43,19 +43,19 @@ tcpdump -i &lt;interface> -s 1500 -w &lt;some-file>
        <note><title>Note!</title>
        <para>
        tcpdump is not part of the Wireshark distribution. You can get it from:
-       <ulink url="http://www.tcpdump.org">http://www.tcpdump.org</ulink> for various 
+       <ulink url="&TcpdumpWebsite;">&TcpdumpWebsite;</ulink> for various 
        platforms.
        </para>
        </note>
   </section>
   
   <section id="AppToolstshark">
-    <title><command>tshark</command>: Terminal-based Wireshark</title>
+    <title><command>TShark</command>: Terminal-based Wireshark</title>
     <para>
       <application>TShark</application> is a terminal oriented version 
-      of ethereal designed for capturing and displaying packets when an 
+      of Wireshark designed for capturing and displaying packets when an 
          interactive user interface isn't necessary or available. It supports 
-         the same options as <command>ethereal</command>. For more 
+         the same options as <command>wireshark</command>. For more 
       information on <command>tshark</command>, see the manual pages 
       (<command>man tshark</command>).
     </para>
@@ -560,7 +560,7 @@ Usage: mergecap [-hva] [-s &lt;snaplen&gt;] [-T &lt;encap type&gt;]
       processable packet dumps from hexdumps of application-level data only.
     </para>
     <para>
-      Text2pcap understands a hexdump of the form generated by od -t x1. In 
+      Text2pcap understands a hexdump of the form generated by od -A x -t x1. In 
       other words, each byte is individually displayed and surrounded with a 
       space. Each line begins with an offset describing the position in the 
       file. The offset is a hex number (can also be octal - see -o), of 
@@ -748,7 +748,7 @@ where &lt;input-filename&gt; specifies input filename (use - for standard input)
   
   <section id="AppToolsidl2wrs" >
     <title><command>idl2wrs</command>: 
-      Creating dissectors from Corba IDL files
+      Creating dissectors from CORBA IDL files
     </title>
     <para>
       In an ideal world idl2wrs would be mentioned in the users guide 
@@ -763,7 +763,7 @@ where &lt;input-filename&gt; specifies input filename (use - for standard input)
        <command>idl2wrs</command> takes a
        user specified IDL file and attempts to build a dissector that
        can decode the IDL traffic over GIOP. The resulting file is
-       "C" code, that should compile okay as an ethereal dissector.
+       "C" code, that should compile okay as a Wireshark dissector.
       </para>
       <para>
        <command>idl2wrs</command> basically parses the data struct given to 
@@ -778,12 +778,12 @@ where &lt;input-filename&gt; specifies input filename (use - for standard input)
            <para>This document</para>
          </listitem>
        </varlistentry>
-       <varlistentry><term><filename>ethereal_be.py</filename></term>
+       <varlistentry><term><filename>wireshark_be.py</filename></term>
          <listitem>
            <para>The main compiler backend</para>
          </listitem>
        </varlistentry>
-       <varlistentry><term><filename>ethereal_gen.py</filename></term>
+       <varlistentry><term><filename>wireshark_gen.py</filename></term>
          <listitem>
            <para>A helper class, that generates the C code.</para>
          </listitem>
@@ -813,13 +813,13 @@ where &lt;input-filename&gt; specifies input filename (use - for standard input)
       <para>
        It is also COOL to work on a great Open Source project such as
        the case with "Wireshark" (
-       <ulink url="http://www.wireshark.org">http://www.wireshark.org</ulink>
+       <ulink url="&WiresharkWebSite;">&WiresharkWebSite;</ulink>
        )
       </para>
     </section>
     <section><title>How to use idl2wrs</title>
       <para>
-       To use the idl2wrs to generate ethereal dissectors, you
+       To use the idl2wrs to generate Wireshark dissectors, you
        need the following:
       </para>
       <orderedlist>
@@ -838,19 +838,19 @@ where &lt;input-filename&gt; specifies input filename (use - for standard input)
        </listitem>
        <listitem>
          <para>
-           Of course you need ethereal installed to compile the
+           Of course you need Wireshark installed to compile the
            code and tweak it if required. idl2wrs is part of the 
            standard Wireshark distribution
          </para>
        </listitem>
       </orderedlist>
       <para>
-       To use idl2wrs to generate an ethereal dissector from an idl file 
+       To use idl2wrs to generate an Wireshark dissector from an idl file 
        use the following procedure:
       </para>
       <orderedlist>
        <title>
-         Procedure for converting a Corba idl file into an ethereal 
+         Procedure for converting a CORBA idl file into a Wireshark 
          dissector
        </title>
        <listitem>
@@ -875,25 +875,25 @@ where &lt;input-filename&gt; specifies input filename (use - for standard input)
       <orderedlist continuation="continues">
        <listitem>
          <para>To write the C code to stdout.
-           <programlisting>Usage: omniidl  -p ./ -b ethereal_be &lt;your file.idl&gt;</programlisting>
+           <programlisting>Usage: omniidl  -p ./ -b wireshark_be &lt;your file.idl&gt;</programlisting>
            eg:
-           <programlisting>omniidl  -p ./ -b ethereal_be echo.idl</programlisting>
+           <programlisting>omniidl  -p ./ -b wireshark_be echo.idl</programlisting>
          </para>
        </listitem>
        <listitem>
          <para>
            To write to a file, just redirect the output.
-           <programlisting>omniidl  -p ./ -b ethereal_be echo.idl > packet-test-idl.c</programlisting>
+           <programlisting>omniidl  -p ./ -b wireshark_be echo.idl > packet-test-idl.c</programlisting>
            You may wish to comment out the register_giop_user_module() code
            and that will leave you with heuristic dissection.
          </para>
        </listitem>
        <listitem>
          <para>
-           Copy the resulting C code to your ethereal src directory, 
-           edit the 2 make files to include the packet-test-idl.c
+           Copy the resulting C code to your Wireshark src directory, 
+           edit the two make files to include the packet-test-idl.c
            <programlisting>
-cp packet-test-idl.c /dir/where/ethereal/lives/
+cp packet-test-idl.c /dir/where/wireshark/lives/
 edit Makefile.am
 edit Makefile.nmake
            </programlisting>
@@ -945,7 +945,7 @@ edit Makefile.nmake
        <listitem>
          <para>
            The "-p ./" option passed to omniidl indicates that the 
-           ethereal_be.py and ethereal_gen.py are residing in the 
+           wireshark_be.py and wireshark_gen.py are residing in the 
            current directory. This may need
            tweaking if you place these files somewhere else.
          </para>