The Tcpdump Group git mirrors - tcpdump/blob - INSTALL

   1 @(#) $Header: /tcpdump/master/tcpdump/Attic/INSTALL,v 1.43 2000-07-29 06:50:51 assar 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://ftp.gnu.org/pub/gnu/gcc/
  11
  12 After libpcap has been built (either install it with "make install" or
  13 make sure both the libpcap and tcpdump source trees are in the same
  14 directory), run ./configure (a shell script).  "configure" will
  15 determine your system attributes and generate an appropriate Makefile
  16 from Makefile.in.  Now build tcpdump by running "make".
  17
  18 If everything builds ok, su and type "make install". This will install
  19 tcpdump and the manual entry. By default, tcpdump is installed with
  20 group execute permissions. The group used depends on your os. In
  21 addition, BPF packet access is controlled by permissions to
  22 /dev/bpf0. In any case, DO NOT give untrusted users the capability of
  23 running tcpdump. Tcpdump can capture any traffic on your net,
  24 including passwords.
  25
  26 Note that most systems ship tcpdump, but usually an older version.
  27 Remember to remove or rename the installed binary when upgrading.
  28
  29 If you use Linux, this version of libpcap is known to compile and run
  30 with 2.0.25 and more modern, and 2.2.x kernels.  It is guaranteed not
  31 to work with 1.X kernels.
  32
  33 If you use OSF 4, note that that there appears to be some serious bugs
  34 with the stock C compiler. The configure code fragments that detect if
  35 the ether_header and ether_arp structs use the ether_addr struct
  36 generates warnings instead of fatal errors (?!?!) This makes configure
  37 think that the ether_arp struct is used when in fact it is not. To get
  38 around this, comment out:
  39
  40 #define ETHER_HEADER_HAS_EA 1
  41 and
  42 #define ETHER_ARP_HAS_EA 1
  43
  44 from config.h 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.
  52
  53 == Tested platforms ==
  54 NetBSD          1.4.1/i386      (mcr, itojun)
  55 RedHat Linux    6.1/i386        (assar)
  56 FreeBSD         2.2.8/i386      (itojun)
  57
  58
  59 FILES
  60 -----
  61 CHANGES         - description of differences between releases
  62 CREDITS         - people that have helped tcpdump along
  63 FILES           - list of files exported as part of the distribution
  64 INSTALL         - this file
  65 Makefile.in     - compilation rules (input to the configure script)
  66 README          - description of distribution
  67 VERSION         - version of this release
  68 acconfig.h      - autoconf input
  69 aclocal.m4      - autoconf macros
  70 addrtoname.c    - address to hostname routines
  71 addrtoname.h    - address to hostname definitions
  72 appletalk.h     - AppleTalk definitions
  73 atime.awk       - TCP ack awk script
  74 bootp.h         - BOOTP definitions
  75 config.guess    - autoconf support
  76 config.h.in     - autoconf input
  77 config.sub      - autoconf support
  78 configure       - configure script (run this first)
  79 configure.in    - configure script source
  80 decnet.h        - DECnet definitions
  81 dhcp6.h         - IPv6 DHCP definitions
  82 dhcp6opt.h      - IPv6 DHCP options
  83 ethertype.h     - ethernet definitions
  84 extract.h       - alignment definitions
  85 fddi.h          - Fiber Distributed Data Interface definitions
  86 gmt2local.c     - time conversion routines
  87 gmt2local.h     - time conversion prototypes
  88 igrp.h          - Interior Gateway Routing Protocol definitions
  89 install-sh      - BSD style install script
  90 interface.h     - globals, prototypes and definitions
  91 ipsec_doi.h     - ISAKMP packet definitions - RFC2407
  92 ipx.h           - IPX definitions
  93 isakmp.h        - ISAKMP packet definitions - RFC2408
  94 l2tp.h          -
  95 lane.h          -
  96 lbl/gnuc.h      - gcc macros and defines
  97 lbl/os-*.h      - os dependent defines and prototypes
  98 linux-include/* - network include files missing on Linux
  99 llc.h           - LLC definitions
 100 machdep.c       - machine dependent routines
 101 machdep.h       - machine dependent definitions
 102 makemib         - mib to header script
 103 mib.h           - mib definitions
 104 missing/*       - replacements for missing library functions
 105 mkdep           - construct Makefile dependency list
 106 nameser.h       - DNS definitions
 107 netbios.h       - NETBIOS definitions
 108 nfs.h           - Network File System V2 definitions
 109 nfsfh.h         - Network File System file handle definitions
 110 ntp.h           - Network Time Protocol definitions
 111 oakley.h        - ISAKMP packet definitions - RFC2409
 112 ospf.h          - Open Shortest Path First definitions
 113 ospf6.h         - IPv6 Open Shortest Path First definitions
 114 packetdat.awk   - TCP chunk summary awk script
 115 parsenfsfh.c    - Network File System file parser routines
 116 ppp.h           - Point to Point Protocol definitions
 117 print-ah.c      - IPSEC Authentication Header printer routines
 118 print-arp.c     - Address Resolution Protocol printer routines
 119 print-ascii.c   - ASCII packet dump routines
 120 print-atalk.c   - AppleTalk printer routines
 121 print-atm.c     - atm printer routines
 122 print-bgp.c     - Border Gateway Protocol printer routines
 123 print-bootp.c   - BOOTP and IPv4 DHCP printer routines
 124 print-chdlc.c   - CHDLC printer routines
 125 print-cip.c     -
 126 print-cnfp.c    - Cisco NetFlow printer routines
 127 print-decnet.c  - DECnet printer routines
 128 print-dhcp6.c   - IPv6 DHCP printer routines
 129 print-domain.c  - Domain Name System printer routines
 130 print-dvmrp.c   - Distance Vector Multicast Routing Protocol printer routines
 131 print-egp.c     - External Gateway Protocol printer routines
 132 print-esp.c     - IPSEC Encapsulating Security Payload printer routines
 133 print-ether.c   - ethernet printer routines
 134 print-fddi.c    - Fiber Distributed Data Interface printer routines
 135 print-frag6.c   - IPv6 fragmentation header printer routines
 136 print-gre.c     - Generic Routing Encapsulation printer routines
 137 print-icmp.c    - Internet Control Message Protocol printer routines
 138 print-icmp6.c   - IPv6 Internet Control Message Protocol printer routines
 139 print-igrp.c    - Interior Gateway Routing Protocol printer routines
 140 print-ip.c      - ip printer routines
 141 print-ip6.c     - IPv6 printer routines
 142 print-ip6opts.c - IPv6 header option printer routines
 143 print-ipcomp.c  - IP Payload Compression Protocol printer routines
 144 print-ipx.c     - IPX printer routines
 145 print-isakmp.c  - Internet Security Association and Key Management Protocol
 146 print-isoclns.c - isoclns printer routines
 147 print-krb.c     - Kerberos printer routines
 148 print-l2tp.c    - Layer Two Tunneling Protocol printer routines
 149 print-lane.c    -
 150 print-lcp.c     -
 151 print-llc.c     - llc printer routines
 152 print-mobile.c  - IPv4 mobility printer routines
 153 print-netbios.c - netbios printer routines
 154 print-nfs.c     - Network File System printer routines
 155 print-ntp.c     - Network Time Protocol printer routines
 156 print-null.c    - null printer routines
 157 print-ospf.c    - Open Shortest Path First printer routines
 158 print-ospf6.c   - IPv6 Open Shortest Path First printer routines
 159 print-pim.c     - Protocol Independent Multicast printer routines
 160 print-ppp.c     - Point to Point Protocol printer routines
 161 print-pppoe.c   -
 162 print-raw.c     - raw printer routines
 163 print-rip.c     - Routing Information Protocol printer routines
 164 print-ripng.c   - IPv6 Routing Information Protocol printer routines
 165 print-rt6.c     - IPv6 routing header printer routines
 166 print-rx.c      - AFS RX printer routines
 167 print-sl.c      - Compressed Serial Line Internet Protocol printer routines
 168 print-smb.c     - SMB (samba) printer routines
 169 print-snmp.c    - Simple Network Management Protocol printer routines
 170 print-stp.c     - IEEE 802.1d spanning tree 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-vrrp.c    - Virtual Router Redundancy Protocol
 178 print-wb.c      - white board printer routines
 179 route6d.h       - packet definition for IPv6 Routing Information Protocol
 180 rx.h            -
 181 savestr.c       - strdup() replacement
 182 savestr.h       - savestr prototypes
 183 send-ack.awk    - unidirectional tcp send/ack awk script
 184 setsignal.c     - os independent signal routines
 185 setsignal.h     - os independent signal prototypes
 186 smb.h           -
 187 smbutil.c       -
 188 stime.awk       - TCP send awk script
 189 strcasecmp.c    - missing routine
 190 tcpdump.1       - manual entry
 191 tcpdump.c       - main program
 192 util.c          - utility routines
 193 vfprintf.c      - emulation routine