Add instructions for using the installation package.

svn path=/trunk/; revision=3282
This commit is contained in:
Gilbert Ramirez 2001-04-10 12:29:22 +00:00
parent 2a2b4bb6b4
commit 466006a3db
1 changed files with 66 additions and 21 deletions

View File

@ -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
=================================================
@ -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
@ -49,14 +112,6 @@ 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
@ -64,16 +119,6 @@ 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
===============================================