Update the Win32 Nmakefiles to reflect the move of the color code into
[obnox/wireshark/wip.git] / README.win32
1 $Id: README.win32,v 1.6 2000/02/09 19:17:50 gram Exp $
2
3 Ethereal can be compiled on Win32 platforms. Some libraries are
4 needed, however.
5
6 The glib, gtk, glib-dev, and gtk-dev packages for win32 can be found
7 at
8         http://www.gimp.org/~tml/gimp/win32
9
10 or
11
12         http://www.iki.fi/tml/gimp/win32/
13
14 (the mirror nearer to you may be faster).
15
16 You will definitely need these.  Download them and unpack them.  As of
17 2000-01-24, at least in one test, some problems have been seen with the
18 versions there; the page in question says
19
20         The latest version of my port, 19991218, might be buggier than
21         the next-to-previous version, 1990828.  If you have problems
22         with the latest version, try the 19990828 version instead.
23
24 and the problems seemed not to be present with the 19990828 version.  If
25 you see problems (e.g., a mangled hex dump window), that version can be
26 found at
27
28         http://www.gimp.org/~tml/gimp/win32/index-19990828.html
29
30 or
31
32         http://www.iki.fi/~tml/gimp/win32/index-19990828.html
33
34 A win32 version libpcap is also needed. You'll need the WinDump 
35 developer's pack available from 
36 http://netgroup-serv.polito.it/windump/install/download.htm
37
38 In order to capture with Win32, you need to install the NDIS
39 packet capture driver available from the same WinDump site.
40
41 The home page for WinDump (TCPdump for Windows) is at:
42 http://netgroup-serv.polito.it/windump/
43
44
45 The UCD SNMP library for win32 can be had from
46 ftp://ftp.revelstone.com/pub/snmp/, but it has not been tested
47 with Ethereal.
48
49 Zlib (or 'libz') is available for Win32 from
50 http://www.winimage.com/zLibDll/
51 but also has not been made to work successfully with Ethereal.
52
53 Instructions for MS Visual C
54 ----------------------------
55 Modify the config.nmake file in the top directory of the Ethereal
56 source tree to work for your local configuration. You should not
57 have to modify any other Makefile.
58
59 Be sure that your command-line environment is set up to compile
60 and linke with MSVC. When installing MSVC, you can have your
61 system's environment set up to always allow compiling from the
62 command line, or you can invoke the vcvars32.bat script.
63
64 In the ethereal directory, type "nmake -f makefile.nmake". It will
65 recurse into the subdirectories as appropriate.
66
67 To do a full build, you will need bison, flex, and bash. However,
68 you can first build on Unix to create the source files that these
69 tools make, then run the build on Windows. That will avoid the need
70 for these tools on your Windows computer.
71
72 Make sure the glib and gtk DLL's are in your path when you run
73 ethereal. This includes gtk-*.dll, glib-*.dll, gmodule-*.dll, gdk-*.dll,
74 and gthread-*.dll
75
76 Instructions for cygwin
77 -----------------------
78 No one has ever compiled ethereal with cygwin. It should not be difficult,
79 however. This spot is reserverd for your instructions on how to compile
80 ethereal with cygwin.
81