README.win32

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