README.win32

   1 $Id: README.win32,v 1.13 2000/09/14 10:02:59 gram Exp $
   2
   3 Running Ethereal, Tethereal, and Editcap on Win32
   4 =================================================
   5 You need the glib and gtk libraries for running Ethereal.
   6
   7 These packages for win32 can be found at:
   8
   9         http://ethereal.zing.org/distribution/win32
  10
  11 and at the home page for the GTK+ for Win32 project:
  12
  13         http://www.gimp.org/~tml/gimp/win32
  14
  15 or
  16         http://www.iki.fi/tml/gimp/win32/
  17
  18 (the mirror nearer to you may be faster).
  19
  20 Make sure the glib and gtk DLL's are in your path when you run
  21 Ethereal. This includes gtk-*.dll, glib-*.dll, gmodule-*.dll, gdk-*.dll,
  22 and gnu-intl.dll. As of the 20000805 GTK+/GLIB distribution, gthread-*.dll
  23 is no longer needed.
  24
  25 The Win32 Binary distribution, available from
  26
  27         http://ethereal.zing.org/distribution/win32
  28
  29 used different version of the GTK+/GLIB libraries at different points
  30 in time:
  31
  32 Ethereal Version                GTK+/GLIB version
  33 ----------------                -----------------
  34 0.8.11 and after                20000805
  35 0.8.9 - 0.8.10                  20000416
  36 0.8.8 and before                19990828
  37
  38
  39 Capturing Packets
  40 -----------------
  41 Remember, if using the the Win32 Binary distribution, available from
  42
  43         http://ethereal.zing.org/distribution/win32
  44
  45 there are two separate packages, one with non-capturing tools, and
  46 one with capturing tools. Install the appropriate package. The
  47 capturing version requires WinPcap, the non-capturing version does not.
  48
  49 In order to capture with Win32, you need to install the NDIS
  50 packet capture driver for your particular Win32 OS; drivers for Windows
  51 9x, Windows NT 4.0, and Windows 2000 can be downlaoded from the
  52 WinPcap home page:
  53
  54         http://netgroup-serv.polito.it/winpcap/
  55
  56 If Ethereal is not capturing packets, you can test your WinPcap
  57 installatino by installing WinDump (TCPdump for Windows) ported by the
  58 same folks who make WinPcap. It's at:
  59
  60         http://netgroup-serv.polito.it/windump/
  61
  62 They also make Analyzer, a GUI sniffer for Win32:
  63
  64         http://netgroup-serv.polito.it/analyzer/
  65
  66
  67 Compiling the Ethereal distribution from source
  68 ===============================================
  69 You'll need the development package for GLIB, GTK+, and WinPcap.
  70 Those versions are available from the respctive home pages for
  71 each project (the same URLs as listed above). The development
  72 packages contain header files and stub libaries to link against.
  73
  74 SNMP and ZLIB are not working yet in Ethereal/Win32, but the
  75 libraries can be had from these locations if you want to hack:
  76
  77 The UCD SNMP library for win32 can be had from
  78
  79         ftp://ftp.revelstone.com/pub/snmp/
  80
  81
  82 Zlib (or 'libz') is available for Win32 from
  83
  84         http://www.winimage.com/zLibDll/
  85
  86
  87
  88 Instructions for MS Visual C
  89 ----------------------------
  90 Modify the config.nmake file in the top directory of the Ethereal
  91 source tree to work for your local configuration. You should not
  92 have to modify any other Makefile.
  93
  94 Be sure that your command-line environment is set up to compile
  95 and link with MSVC. When installing MSVC, you can have your
  96 system's environment set up to always allow compiling from the
  97 command line, or you can invoke the vcvars32.bat script.
  98
  99 In the ethereal directory, type "nmake -f makefile.nmake". It will
 100 recurse into the subdirectories as appropriate.
 101
 102 Some generated source is created by traditionally "Unix-ish" tools.
 103 If you are building from an official distribution, these files are
 104 already generated, so you have nothing to worry about unless you
 105 modify the source. If building from a CVS image, you'll need the tools
 106 to generate C source. The "special" files and their requisite tools are:
 107
 108 Source                          Output                  Tool
 109 ------                          ------                  ----
 110 dfilter-grammar.y               *.[ch]                  Bison or Yacc
 111 dfilter-scanner.l               *.c                     Flex
 112 wiretap/ascend-grammar.y        *.[ch]                  Bison or Yacc
 113 wiretap/ascend-scanner.l        *.c                     Flex
 114 make-reg-dotc, packet*.c        register.c              Bash
 115 ncp2222.py                      packet-ncp2222.c        Python
 116
 117
 118 However, if you have a Unix system handy, you can first build on Unix
 119 to create the source files that these tools make, then run the build
 120 on Windows.  That will avoid the need for these tools on your Windows
 121 computer.
 122
 123 If you don't have a Unix system handy, most of those tools are available for
 124 Win32 systems as part of the Cygwin package:
 125
 126         http://sourceware.cygnus.com/cygwin/
 127
 128 After installing them, you will probably have to modify the config.nmake
 129 file to specify where the Cygwin binaries are installed.
 130
 131 Python for Win32 is available from
 132
 133         http://www.python.org/
 134
 135
 136 Instructions for Cygwin
 137 -----------------------
 138 No one has ever compiled Ethereal entirely with Cygwin.  It should not
 139 be difficult, however.  This spot is reserverd for your instructions on
 140 how to compile Ethereal with Cygwin.