wireshark/README.win32

$Id: README.win32,v 1.8 2000/04/13 09:03:32 guy Exp $

Ethereal can be compiled on Win32 platforms. Some libraries are
needed, however.

The glib, gtk, glib-dev, and gtk-dev packages for win32 can be found
at
	http://www.gimp.org/~tml/gimp/win32

or

	http://www.iki.fi/tml/gimp/win32/

(the mirror nearer to you may be faster).

You will definitely need these.  Download them and unpack them.  As of
2000-01-24, at least in one test, some problems have been seen with the
versions there; the page in question says

	The latest version of my port, 19991218, might be buggier than
	the next-to-previous version, 1990828.  If you have problems
	with the latest version, try the 19990828 version instead.

and the problems seemed not to be present with the 19990828 version.  If
you see problems (e.g., a mangled hex dump window), that version can be
found at

	http://www.gimp.org/~tml/gimp/win32/index-19990828.html

or

	http://www.iki.fi/~tml/gimp/win32/index-19990828.html

If you want to be able to capture packets, a Win32 version libpcap is
also needed.  You'll need the WinPcap developer's pack available from

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

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 are included in the WinPcap
developer's pack.

The home page for WinDump (TCPdump for Windows), which uses the Win32
libpcap, is at:

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

The UCD SNMP library for win32 can be had from

	ftp://ftp.revelstone.com/pub/snmp/

but it has not been tested with Ethereal.

Zlib (or 'libz') is available for Win32 from

	http://www.winimage.com/zLibDll/

but also has not been made to work successfully with Ethereal.

Instructions for MS Visual C
----------------------------
Modify the config.nmake file in the top directory of the Ethereal
source tree to work for your local configuration. You should not
have to modify any other Makefile.

Be sure that your command-line environment is set up to compile
and link with MSVC. When installing MSVC, you can have your
system's environment set up to always allow compiling from the
command line, or you can invoke the vcvars32.bat script.

In the ethereal directory, type "nmake -f makefile.nmake". It will
recurse into the subdirectories as appropriate.

To do a full build, you will need bison, flex, and bash. However,
you can first build on Unix to create the source files that these
tools make, then run the build on Windows. That will avoid the need
for these tools on your Windows computer.

Make sure the glib and gtk DLL's are in your path when you run
ethereal. This includes gtk-*.dll, glib-*.dll, gmodule-*.dll, gdk-*.dll,
and gthread-*.dll

Instructions for cygwin
-----------------------
No one has ever compiled ethereal with cygwin. It should not be difficult,
however. This spot is reserverd for your instructions on how to compile
ethereal with cygwin.