The Tcpdump Group git mirrors - tcpdump/blob - INSTALL

   1 @(#) $Header: /tcpdump/master/tcpdump/Attic/INSTALL,v 1.40 2000-01-30 17:30:17 itojun 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, comment out:
  41
  42 #define ETHER_HEADER_HAS_EA 1
  43 and
  44 #define ETHER_ARP_HAS_EA 1
  45
  46 from config.h after running configure (and before attempting to
  47 compile tcpdump).
  48
  49 Another workaround is to use gcc.
  50
  51 If your system is not one which we have tested tcpdump on, you may have
  52 to modify the configure script and Makefile.in. Please send us patches
  53 for any modifications you need to make.
  54
  55 == Tested platforms ==
  56 NetBSD          1.4.1/i386      (mcr, itojun)
  57 RedHat Linux    6.1/i386        (assar)
  58 FreeBSD         2.2.8/i386      (itojun)
  59
  60
  61 FILES
  62 -----
  63 CHANGES         - description of differences between releases
  64 FILES           - list of files exported as part of the distribution
  65 INSTALL         - this file
  66 Makefile.in     - compilation rules (input to the configure script)
  67 README          - description of distribution
  68 README-AFS      -
  69 VERSION         - version of this release
  70 acconfig.h      - autoconf input
  71 aclocal.m4      - autoconf macros
  72 addrtoname.c    - address to hostname routines
  73 addrtoname.h    - address to hostname definitions
  74 appletalk.h     - AppleTalk definitions
  75 atime.awk       - TCP ack awk script
  76 bootp.h         - BOOTP definitions
  77 bpf_dump.c      - bpf instruction pretty-printer routine
  78 config.guess    - autoconf support
  79 config.h.in     - autoconf input
  80 config.sub      - autoconf support
  81 configure       - configure script (run this first)
  82 configure.in    - configure script source
  83 decnet.h        - DECnet definitions
  84 dhcp6.h         - IPv6 DHCP definitions
  85 dhcp6opt.h      - IPv6 DHCP options
  86 ethertype.h     - ethernet definitions
  87 extract.h       - alignment definitions
  88 fddi.h          - Fiber Distributed Data Interface definitions
  89 gmt2local.c     - time conversion routines
  90 gmt2local.h     - time conversion prototypes
  91 igrp.h          - Interior Gateway Routing Protocol definitions
  92 install-sh      - BSD style install script
  93 interface.h     - globals, prototypes and definitions
  94 ipsec_doi.h     - ISAKMP packet definitions - RFC2407
  95 ipx.h           - IPX definitions
  96 isakmp.h        - ISAKMP packet definitions - RFC2408
  97 l2tp.h          -
  98 lane.h          -
  99 lbl/gnuc.h      - gcc macros and defines
 100 lbl/os-*.h      - os dependent defines and prototypes
 101 linux-include/* - network include files missing on Linux
 102 llc.h           - LLC definitions
 103 machdep.c       - machine dependent routines
 104 machdep.h       - machine dependent definitions
 105 makemib         - mib to header script
 106 mib.h           - mib definitions
 107 missing/*       - replacements for missing library functions
 108 mkdep           - construct Makefile dependency list
 109 netbios.h       - NETBIOS definitions
 110 nfs.h           - Network File System V2 definitions
 111 nfsfh.h         - Network File System file handle definitions
 112 ntp.h           - Network Time Protocol definitions
 113 oakley.h        - ISAKMP packet definitions - RFC2409
 114 ospf.h          - Open Shortest Path First definitions
 115 ospf6.h         - IPv6 Open Shortest Path First definitions
 116 packetdat.awk   - TCP chunk summary awk script
 117 parsenfsfh.c    - Network File System file parser routines
 118 ppp.h           - Point to Point Protocol definitions
 119 print-ah.c      - IPSEC Authentication Header printer routines
 120 print-arp.c     - Address Resolution Protocol printer routines
 121 print-ascii.c   - ASCII packet dump routines
 122 print-atalk.c   - AppleTalk printer routines
 123 print-atm.c     - atm printer routines
 124 print-bgp.c     - Border Gateway Protocol printer routines
 125 print-bootp.c   - BOOTP and IPv4 DHCP printer routines
 126 print-chdlc.c   - CHDLC printer routines
 127 print-cip.c     -
 128 print-decnet.c  - DECnet printer routines
 129 print-dhcp6.c   - IPv6 DHCP printer routines
 130 print-domain.c  - Domain Name System printer routines
 131 print-dvmrp.c   - Distance Vector Multicast Routing Protocol printer routines
 132 print-egp.c     - External Gateway Protocol printer routines
 133 print-esp.c     - IPSEC Encapsulating Security Payload printer routines
 134 print-ether.c   - ethernet printer routines
 135 print-fddi.c    - Fiber Distributed Data Interface printer routines
 136 print-frag6.c   - IPv6 fragmentation header printer routines
 137 print-gre.c     - Generic Routing Encapsulation printer routines
 138 print-icmp.c    - Internet Control Message Protocol printer routines
 139 print-icmp6.c   - IPv6 Internet Control Message Protocol printer routines
 140 print-igrp.c    - Interior Gateway Routing Protocol printer routines
 141 print-ip.c      - ip printer routines
 142 print-ip6.c     - IPv6 printer routines
 143 print-ip6opts.c - IPv6 header option printer routines
 144 print-ipcomp.c  - IP Payload Compression Protocol printer routines
 145 print-ipx.c     - IPX printer routines
 146 print-isakmp.c  - Internet Security Association and Key Management Protocol
 147 print-isoclns.c - isoclns printer routines
 148 print-krb.c     - Kerberos printer routines
 149 print-l2tp.c    - Layer Two Tunneling Protocol printer routines
 150 print-lane.c    -
 151 print-lcp.c     -
 152 print-llc.c     - llc printer routines
 153 print-mobile.c  - IPv4 mobility printer routines
 154 print-netbios.c - netbios printer routines
 155 print-nfs.c     - Network File System printer routines
 156 print-ntp.c     - Network Time Protocol printer routines
 157 print-null.c    - null printer routines
 158 print-ospf.c    - Open Shortest Path First printer routines
 159 print-ospf6.c   - IPv6 Open Shortest Path First printer routines
 160 print-pim.c     - Protocol Independent Multicast printer routines
 161 print-ppp.c     - Point to Point Protocol printer routines
 162 print-pppoe.c   -
 163 print-raw.c     - raw printer routines
 164 print-rip.c     - Routing Information Protocol printer routines
 165 print-ripng.c   - IPv6 Routing Information Protocol printer routines
 166 print-rt6.c     - IPv6 routing header printer routines
 167 print-rx.c      - AFS RX printer routines
 168 print-sl.c      - Compressed Serial Line Internet Protocol printer routines
 169 print-smb.c     - SMB (samba) printer routines
 170 print-snmp.c    - Simple Network Management Protocol printer routines
 171 print-sunrpc.c  - Sun Remote Procedure Call printer routines
 172 print-tcp.c     - TCP printer routines
 173 print-telnet.c  - Telnet option printer routines
 174 print-tftp.c    - Trivial File Transfer Protocol printer routines
 175 print-udp.c     - UDP printer routines
 176 print-vjc.c     - PPP Van Jacovson compression (RFC1144) printer routines
 177 print-wb.c      - white board printer routines
 178 route6d.h       - packet definition for IPv6 Routing Information Protocol
 179 rx.h            -
 180 savestr.c       - strdup() replacement
 181 savestr.h       - savestr prototypes
 182 send-ack.awk    - unidirectional tcp send/ack awk script
 183 setsignal.c     - os independent signal routines
 184 setsignal.h     - os independent signal prototypes
 185 smb.h           -
 186 smbutil.c       -
 187 stime.awk       - TCP send awk script
 188 strcasecmp.c    - missing routine
 189 tcpdump.1       - manual entry
 190 tcpdump.c       - main program
 191 util.c          - utility routines
 192 vfprintf.c      - emulation routine