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          ftp://ftp.ee.lbl.gov .
  24
  25          Make sure you install the headers ('make install-incl') when you
  26          install the library.
  27
  28          New development of libpcap is occurring at www.tcpdump.org
  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   [ ] 4. Run 'make'.  Hopefully, you won't run into any problems.
  53
  54   [ ] 5. Run './ethereal', and make sure things are working.  You must
  55          have root privileges in order to capture live data.
  56
  57   [ ] 6. Run 'make install'.  If you wish to install the man page, run
  58          'make install-man'.  You're done.