Skip to content

Commit

Permalink
Add instructions for using the installation package.
Browse files Browse the repository at this point in the history
svn path=/trunk/; revision=3282
  • Loading branch information
gilramir committed Apr 10, 2001
1 parent 2a2b4bb commit 466006a
Showing 1 changed file with 66 additions and 21 deletions.
87 changes: 66 additions & 21 deletions README.win32
Original file line number Diff line number Diff line change
@@ -1,4 +1,67 @@
$Id: README.win32,v 1.22 2001/04/09 06:12:51 guy Exp $
$Id: README.win32,v 1.23 2001/04/10 12:29:22 gram Exp $

Installing Ethereal, Tethereal, and Editcap on Win32
====================================================
These are the instructions for installing Ethereal
from the installation executable that is provided on
the Ethereal website and any of its mirrors.

The installation package allows you to install:

o Ethereal - the GUI version
o Tethereal - the console, line-mode version
o Editcap - a console, line-mode utility to convert
capture files from one format to another.
(The same functions are available in Ethereal)

Additionally, the installation package contains a "plugins"
option, which installs the Gryphon and MGCP dissector plugins
for use with Ethereal and Tethereal.

The "Debug PDB Files" are useful to install if you are experiencing
a crash when running and Ethereal. Dr. Watson or your debugger
can use the information in these files to provide useful information
to the Ethereal developers that will help them pinpoint the problem.
However, for general usage of Ethereal, these files are not
necessary. In the future, we may package them separately from
Ethereal.

In the past, two versions of Ethereal binaries were published -- a
version that could capture packets and a version which could not.
The latter is useful if you're only reading files produced by
another product (e.g., a sniffer, firewall, or intrustion detection system)
and did not wish to install WinPcap, the library Ethereal uses
to capture packets on Win32 platforms.

Now that WinPcap 2.1 has been released as a DLL, Ethereal can
detect its presence at run time. Thus, only one version of
the Ethereal binaries need to be shipped.

If you don't want to capture packets, just install the Ethereal
package. If you do want to capture packets, install Ethereal *and*
install WinPcap 2.1, available from:

http://netgroup-serv.polito.it/winpcap/

If you already have WinPcap 2.0 installed, you need to un-install
it and install WinPcap 2.1. If you use other applications
that use WinPcap 2.0, you will have to decide which applications
to keep, since WinPcap 2.0 and WinPcap 2.1 cannot be installed
on the same system at the same time.

If Ethereal is not capturing packets and you have WinPcap installed,
you can test your WinPcap installation by installing WinDump
(TCPdump for Windows) ported by the same folks who make WinPcap. It's at:

http://netgroup-serv.polito.it/windump/

They also make Analyzer, a GUI sniffer for Win32:

http://netgroup-serv.polito.it/analyzer/

The rest of this documentation is only interesting if
you want to compile Ethereal yourself.


Running Ethereal, Tethereal, and Editcap on Win32
=================================================
Expand Down Expand Up @@ -29,8 +92,8 @@ Yes, the location of plugins needs to be more flexible.
Make sure the glib and gtk DLL's are in your path - i.e., that your path
includes the directory (folder) or directories (folders) in which those
DLLs are found - when you run Ethereal. This includes gtk-*.dll,
glib-*.dll, gmodule-*.dll, gdk-*.dll, and gnu-intl.dll. As of the
20000805 GTK+/GLIB distribution, gthread-*.dll is no longer needed.
glib-*.dll, gmodule-*.dll, gdk-*.dll, gnu-intl.dll, and iconv-*.dll.
As of the 20000805 GTK+/GLIB distribution, gthread-*.dll is no longer needed.

The Win32 Binary distribution, available from

Expand All @@ -49,31 +112,13 @@ Ethereal Version GTK+/GLIB version

Capturing Packets
-----------------
Remember, if using the the Win32 Binary distribution, available from

http://www.ethereal.com/distribution/win32

there are two separate packages, one with non-capturing tools, and
one with capturing tools. Install the appropriate package. The
capturing version requires WinPcap 2.1, the non-capturing version does not.

In order to capture with Win32, you need to install the NDIS
packet capture driver for your particular Win32 OS; drivers for Windows
9x, Windows NT 4.0, and Windows 2000 can be downloaded from the
WinPcap home page:

http://netgroup-serv.polito.it/winpcap/

If Ethereal is not capturing packets, you can test your WinPcap
installation by installing WinDump (TCPdump for Windows) ported by the
same folks who make WinPcap. It's at:

http://netgroup-serv.polito.it/windump/

They also make Analyzer, a GUI sniffer for Win32:

http://netgroup-serv.polito.it/analyzer/


Compiling the Ethereal distribution from source
===============================================
Expand Down

0 comments on commit 466006a

Please sign in to comment.