diff --git a/README.win32 b/README.win32 index 370ce37a2e..ad1d547b83 100644 --- a/README.win32 +++ b/README.win32 @@ -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 ===============================================