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. Make sure you have GNU libtool installed.  Try running 'libtool
  21          --version'.  If you need to install/reinstall GTK, you can find
  22          it at
  23
  24          http://www.profitpress.com/libtool/ .
  25
  26          Ethereal needs libtool-1.3.4.
  27
  28   [ ] 3. If you want to capture packets, make sure you have libpcap
  29          installed.  The latest "official" version can be found at
  30
  31          ftp://ftp.ee.lbl.gov .
  32
  33          Make sure you install the headers ('make install-incl') when you
  34          install the library.
  35
  36          New development of libpcap is occurring at www.tcpdump.org
  37
  38          If you installed libpcap from a binary package, you may have to
  39          install a "development" package; for example, there's
  40          apparently a "libpcap0" Debian package, but it just includes a
  41          shared library, a copyright notice, changelog files, and a
  42          README file - you also need to install a "libpcap-dev" package
  43          to get header files, a non-shared library, and the man page.
  44          Similarly, Red Hat 5.x users will need to install a "libpcap-devel"
  45          .rpm to go along with the "libpcap" .rpm.
  46
  47   [ ] 4. Run './configure' in the Ethereal distribution directory.
  48          Running './configure --help' displays a list of options.
  49          The file 'INSTALL.configure' contains general instructions for
  50          using 'configure' and 'make'.
  51
  52          Ethereal installs a support file (manuf) in /usr/local/etc by
  53          default.  You can change this location with the --sysconfdir
  54          option.
  55
  56          The --disable-pcap option allows you to compile without libpcap.
  57          You won't be able to capture packets, but you can read traces
  58          that have already been captured to disk by other programs.
  59
  60   [ ] 5. Run 'make'.  Hopefully, you won't run into any problems.
  61
  62   [ ] 6. Run './ethereal', and make sure things are working.  You must
  63          have root privileges in order to capture live data.
  64
  65   [ ] 7. Run 'make install'.  If you wish to install the man page, run
  66          'make install-man'.  You're done.