INSTALL

   1 Installation Checklist
   2 ======================
   3
   4   [ ] 0. This is alpha software.  Beware.
   5
   6   [ ] 1. Make sure you have GTK+ installed.  Try running 'gtk-config
   7          --version'.  If you need to install/reinstall GTK, you can find
   8          it at
   9
  10          http://www.gtk.org .
  11
  12          Ethereal needs gtk+-1.2.0 or above.
  13
  14          If you installed GTK+ from a binary package, you may have to
  15          install a "development" package; there may be separate "user's"
  16          and "developer's" packages, with the former not including
  17          header files and the like.  For example, Red Hat users will
  18          need to install a "gtk-devel" .rpm.
  19
  20   [ ] 2. If you want to capture packets, make sure you have libpcap
  21          installed.  The latest "official" version can be found at
  22
  23          http://www.tcpdump.org .
  24
  25          If you've downloaded the 0.5.2 version, make sure you install
  26          the headers ('make install-incl') when you install the library.
  27          The CVS snapshots will install the headers if you do 'make
  28          install', and have no 'install-incl' target.
  29
  30          If you installed libpcap from a binary package, you may have to
  31          install a "development" package; for example, there's
  32          apparently a "libpcap0" Debian package, but it just includes a
  33          shared library, a copyright notice, changelog files, and a
  34          README file - you also need to install a "libpcap-dev" package
  35          to get header files, a non-shared library, and the man page.
  36          Similarly, Red Hat 5.x users will need to install a "libpcap-devel"
  37          .rpm to go along with the "libpcap" .rpm.
  38
  39   [ ] 3. Run './configure' in the Ethereal distribution directory.
  40          Running './configure --help' displays a list of options.
  41          The file 'INSTALL.configure' contains general instructions for
  42          using 'configure' and 'make'.
  43
  44          Ethereal installs a support file (manuf) in /usr/local/etc by
  45          default.  You can change this location with the --sysconfdir
  46          option.
  47
  48          The --disable-pcap option allows you to compile without libpcap.
  49          You won't be able to capture packets, but you can read traces
  50          that have already been captured to disk by other programs.
  51
  52          You can build or not build ethereal, tethereal, editcap, and
  53          mergecap with the appropriate --enable-XXX or --disable-XXX flags.
  54          The default is to build everything. If GTK+ is not detected
  55          on the system, then ethereal won't be built.
  56
  57   [ ] 4. Run 'make'.  Hopefully, you won't run into any problems.
  58
  59   [ ] 5. Run './ethereal', and make sure things are working.  You must
  60          have root privileges in order to capture live data.
  61
  62   [ ] 6. Run 'make install'.  If you wish to install the man page, run
  63          'make install-man'.  You're done.