The Tcpdump Group git mirrors - tcpdump/blob - INSTALL

   1 @(#) $Header: /tcpdump/master/tcpdump/Attic/INSTALL,v 1.36 1999-10-07 23:47:09 mcr Exp $ (LBL)
   2
   3 If you have not built libpcap, do so first.  See the README
   4 file in this directory for the ftp location.
   5
   6 You will need an ANSI C compiler to build tcpdump. The configure script
   7 will abort if your compiler is not ANSI compliant. If this happens, use
   8 the GNU C compiler, available via anonymous ftp:
   9
  10         ftp://prep.ai.mit.edu/pub/gnu/gcc.tar.gz
  11
  12 After libpcap has been built (either install it with "make install" and
  13 "make install-incl" or make sure both the libpcap and tcpdump source
  14 trees are in the same directory), edit the BINDEST and MANDEST paths in
  15 Makefile.in and run ./configure (a shell script).  "configure" will
  16 determine your system attributes and generate an appropriate Makefile
  17 from Makefile.in.  Now build tcpdump by running "make".
  18
  19 If everything builds ok, su and type "make install" (and optionally
  20 "make install-man). This will install tcpdump and the manual entry. By
  21 default, tcpdump is installed with group execute permissions. The group
  22 used depends on your os. In addition, BPF packet access is controlled
  23 by permissions to /dev/bpf0. In any case, DO NOT give untrusted users
  24 the capability of running tcpdump. Tcpdump can capture any traffic on
  25 your net, including passwords.
  26
  27 Note that tcpdump is shipped with some systems, for example, DEC/OSF
  28 and BSD/386.  Remember to remove or rename the installed binary
  29 when upgrading.
  30
  31 If you use Linux, this version of libpcap is known to compile and run
  32 under Red Hat 4.0 with the 2.0.25 kernel. It may work with earlier 2.X
  33 versions but is guaranteed not to work with 1.X kernels.
  34
  35 If you use OSF 4, note that that there appears to be some serious bugs
  36 with the stock C compiler. The configure code fragments that detect if
  37 the ether_header and ether_arp structs use the ether_addr struct
  38 generates warnings instead of fatal errors (?!?!) This makes configure
  39 think that the ether_arp struct is used when in fact it is not. To get
  40 around this, delete:
  41
  42     -DETHER_HEADER_HAS_EA=1 -DETHER_ARP_HAS_EA=1
  43
  44 from the Makefile after running configure (and before attempting to
  45 compile tcpdump.
  46
  47 Another workaround is to use gcc.
  48
  49 If your system is not one which we have tested tcpdump on, you may have
  50 to modify the configure script and Makefile.in. Please send us patches
  51 for any modifications you need to make. However, we are not interested
  52 in ascii packet printer patches. We believe adding this feature would
  53 make it too easy for crackers who do not have the programming skills
  54 needed to write a password sniffer to grab clear text passwords.
  55
  56 FILES
  57 -----
  58 CHANGES         - description of differences between releases
  59 FILES           - list of files exported as part of the distribution
  60 INSTALL         - this file
  61 Makefile.in     - compilation rules (input to the configure script)
  62 README          - description of distribution
  63 VERSION         - version of this release
  64 aclocal.m4      - autoconf macros
  65 addrtoname.c    - address to hostname routines
  66 addrtoname.h    - address to hostname definitions
  67 appletalk.h     - AppleTalk definitions
  68 atime.awk       - TCP ack awk script
  69 bcopy.c         - missing routine
  70 bootp.h         - BOOTP definitions
  71 bpf_dump.c      - bpf instruction pretty-printer routine
  72 config.guess    - autoconf support
  73 config.sub      - autoconf support
  74 configure       - configure script (run this first)
  75 configure.in    - configure script source
  76 decnet.h        - DECnet definitions
  77 ethertype.h     - ethernet definitions
  78 extract.h       - alignment definitions
  79 fddi.h          - Fiber Distributed Data Interface definitions
  80 gmt2local.c     - time conversion routines
  81 gmt2local.h     - time conversion prototypes
  82 igrp.h          - Interior Gateway Routing Protocol definitions
  83 install-sh      - BSD style install script
  84 interface.h     - globals, prototypes and definitions
  85 ipx.h           - IPX definitions
  86 lbl/gnuc.h      - gcc macros and defines
  87 lbl/os-*.h      - os dependent defines and prototypes
  88 linux-include/* - network include files missing on Linux
  89 llc.h           - LLC definitions
  90 machdep.c       - machine dependent routines
  91 machdep.h       - machine dependent definitions
  92 makemib         - mib to header script
  93 mib.h           - mib definitions
  94 mkdep           - construct Makefile dependency list
  95 netbios.h       - NETBIOS definitions
  96 nfsfh.h         - Network File System file handle definitions
  97 nfsv2.h         - Network File System V2 definitions
  98 ntp.h           - Network Time Protocol definitions
  99 ospf.h          - Open Shortest Path First definitions
 100 packetdat.awk   - TCP chunk summary awk script
 101 parsenfsfh.c    - Network File System file parser routines
 102 ppp.h           - Point to Point Protocol definitions
 103 print-arp.c     - Address Resolution Protocol printer routines
 104 print-atalk.c   - AppleTalk printer routines
 105 print-atm.c     - atm printer routines
 106 print-bootp.c   - BOOTP printer routines
 107 print-decnet.c  - DECnet printer routines
 108 print-domain.c  - Domain Name System printer routines
 109 print-egp.c     - External Gateway Protocol printer routines
 110 print-ether.c   - ethernet printer routines
 111 print-fddi.c    - Fiber Distributed Data Interface printer routines
 112 print-gre.c     - Generic Routing Encapsulation printer routines
 113 print-icmp.c    - Internet Control Message Protocol printer routines
 114 print-igrp.c    - Interior Gateway Routing Protocol printer routines
 115 print-ip.c      - ip printer routines
 116 print-ipx.c     - IPX printer routines
 117 print-isoclns.c - isoclns printer routines
 118 print-krb.c     - Kerberos printer routines
 119 print-llc.c     - llc printer routines
 120 print-netbios.c - netbios printer routines
 121 print-nfs.c     - Network File System printer routines
 122 print-ntp.c     - Network Time Protocol printer routines
 123 print-null.c    - null printer routines
 124 print-ospf.c    - Open Shortest Path First printer routines
 125 print-pim.c     - Protocol Independent Multicast printer routines
 126 print-ppp.c     - Point to Point Protocol printer routines
 127 print-raw.c     - raw printer routines
 128 print-rip.c     - Routing Information Protocol printer routines
 129 print-sl.c      - Compressed Serial Line Internet Protocol printer routines
 130 print-snmp.c    - Simple Network Management Protocol printer routines
 131 print-sunrpc.c  - Sun Remote Procedure Call printer routines
 132 print-tcp.c     - TCP printer routines
 133 print-tftp.c    - Trivial File Transfer Protocol printer routines
 134 print-udp.c     - UDP printer routines
 135 print-wb.c      - white board printer routines
 136 savestr.c       - savestr prototypes
 137 savestr.h       - strdup() replacement
 138 send-ack.awk    - unidirectional tcp send/ack awk script
 139 setsignal.c     - os independent signal routines
 140 setsignal.h     - os independent signal prototypes
 141 stime.awk       - TCP send awk script
 142 strcasecmp.c    - missing routine
 143 tcpdump.1       - manual entry
 144 tcpdump.c       - main program
 145 util.c          - utility routines
 146 vfprintf.c      - emulation routine