README.win32

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