README.win32

   1 $Id: README.win32,v 1.10 2000/06/08 03:12:52 gram Exp $
   2
   3 Using and Compiling Ethereal on Win32
   4
   5 (Including Tethereal and Editcap)
   6
   7
   8
   9 Ethereal can be compiled and used on Win32 platforms. You'll need
  10 some additional libraries, however.
  11
  12 The glib, gtk, glib-dev, and gtk-dev packages for win32 can be found
  13 at
  14         http://www.gimp.org/~tml/gimp/win32
  15
  16 or
  17         http://www.iki.fi/tml/gimp/win32/
  18
  19 (the mirror nearer to you may be faster).
  20
  21 You need the glib and gtk libraries for running Ethereal. You'll
  22 need the *-dev packages for compiling Ethereal.
  23
  24 Some problems had been seen with versions of those libraries after the
  25 1999-08-28 version but before the 2000-04-16 version, but those problems
  26 don't appear to occur with the 2000-04-16 version.  If you see problems
  27 (e.g., a mangled hex dump window), the 1999-08-28 version can be found at
  28
  29         http://www.gimp.org/~tml/gimp/win32/index-19990828.html
  30
  31 or
  32
  33         http://www.iki.fi/~tml/gimp/win32/index-19990828.html
  34
  35 If you want to be able to capture packets, a Win32 version libpcap is
  36 also needed.  You'll need the WinPcap developer's pack available from
  37
  38         http://netgroup-serv.polito.it/winpcap/
  39
  40 In order to capture with Win32, you need to install the NDIS
  41 packet capture driver for your particular Win32 OS; drivers for Windows
  42 9x, Windows NT 4.0, and Windows 2000 are included in the WinPcap
  43 developer's pack.
  44
  45 The home page for WinDump (TCPdump for Windows), which uses the Win32
  46 libpcap, is at:
  47
  48         http://netgroup-serv.polito.it/windump/
  49
  50 The UCD SNMP library for win32 can be had from
  51
  52         ftp://ftp.revelstone.com/pub/snmp/
  53
  54 but it has not been tested with Ethereal.
  55
  56 Zlib (or 'libz') is available for Win32 from
  57
  58         http://www.winimage.com/zLibDll/
  59
  60 but also has not been made to work successfully with Ethereal.
  61
  62 Instructions for MS Visual C
  63 ----------------------------
  64 Modify the config.nmake file in the top directory of the Ethereal
  65 source tree to work for your local configuration. You should not
  66 have to modify any other Makefile.
  67
  68 Be sure that your command-line environment is set up to compile
  69 and link with MSVC. When installing MSVC, you can have your
  70 system's environment set up to always allow compiling from the
  71 command line, or you can invoke the vcvars32.bat script.
  72
  73 In the ethereal directory, type "nmake -f makefile.nmake". It will
  74 recurse into the subdirectories as appropriate.
  75
  76 To do a full build, or if you modify any of the ".y" files, any of the
  77 ".l" files, or any of the dissector files, you will need Bison, Flex,
  78 Bash, and various other UNIX-compatible utilities.  However, if you have
  79 a Unix system handy, you can first build on Unix to create the source
  80 files that these tools make, then run the build on Windows.  That will
  81 avoid the need for these tools on your Windows computer.
  82
  83 If you don't have a Unix system handy, those tools are available for
  84 Win32 systems as part of the Cygwin package:
  85
  86         http://sourceware.cygnus.com/cygwin/
  87
  88 After installing them, you will probably have to modify the config.nmake
  89 file to specify where the Cygwin binaries are installed.
  90
  91 Make sure the glib and gtk DLL's are in your path when you run
  92 Ethereal. This includes gtk-*.dll, glib-*.dll, gmodule-*.dll, gdk-*.dll,
  93 and gthread-*.dll.
  94
  95 Instructions for Cygwin
  96 -----------------------
  97 No one has ever compiled Ethereal entirely with Cygwin.  It should not
  98 be difficult, however.  This spot is reserverd for your instructions on
  99 how to compile Ethereal with Cygwin.