Fix the appearance of the option menus in the GUI preference box.
[obnox/wireshark/wip.git] / 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          Make sure you install the headers ('make install-incl') when you
26          install the library.
27
28          If you installed libpcap from a binary package, you may have to
29          install a "development" package; for example, there's
30          apparently a "libpcap0" Debian package, but it just includes a
31          shared library, a copyright notice, changelog files, and a
32          README file - you also need to install a "libpcap-dev" package
33          to get header files, a non-shared library, and the man page.
34          Similarly, Red Hat 5.x users will need to install a "libpcap-devel"
35          .rpm to go along with the "libpcap" .rpm.
36
37   [ ] 3. Run './configure' in the Ethereal distribution directory.
38          Running './configure --help' displays a list of options.
39          The file 'INSTALL.configure' contains general instructions for
40          using 'configure' and 'make'.
41
42          Ethereal installs a support file (manuf) in /usr/local/etc by
43          default.  You can change this location with the --sysconfdir
44          option.
45
46          The --disable-pcap option allows you to compile without libpcap.
47          You won't be able to capture packets, but you can read traces
48          that have already been captured to disk by other programs.
49
50   [ ] 4. Run 'make'.  Hopefully, you won't run into any problems.
51
52   [ ] 5. Run './ethereal', and make sure things are working.  You must
53          have root privileges in order to capture live data.
54
55   [ ] 6. Run 'make install'.  If you wish to install the man page, run
56          'make install-man'.  You're done.