contrib/tcpdump/INSTALL

   1 @(#) $Header: /tcpdump/master/tcpdump/INSTALL,v 1.56.2.3 2004/03/17 19:47:47 guy 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 and later, kernels.  It is
  31 guaranteed not to work with 1.X kernels.
  32
  33 If your system is not one which we have tested tcpdump on, you may have
  34 to modify the configure script and Makefile.in. Please send us patches
  35 for any modifications you need to make.
  36
  37 Please see "PLATFORMS" for notes about tested platforms.
  38
  39
  40 FILES
  41 -----
  42 CHANGES         - description of differences between releases
  43 CREDITS         - people that have helped tcpdump along
  44 FILES           - list of files exported as part of the distribution
  45 INSTALL         - this file
  46 LICENSE         - the license under which tcpdump is distributed
  47 Makefile.in     - compilation rules (input to the configure script)
  48 README          - description of distribution
  49 Readme.Win32    - notes on building tcpdump on Win32 systems (with WinPcap)
  50 VERSION         - version of this release
  51 acconfig.h      - autoconf input
  52 aclocal.m4      - autoconf macros
  53 addrtoname.c    - address to hostname routines
  54 addrtoname.h    - address to hostname definitions
  55 ah.h            - IPSEC Authentication Header definitions
  56 aodv.h          - AODV definitions
  57 appletalk.h     - AppleTalk definitions
  58 arcnet.h        - ARCNET definitions
  59 atime.awk       - TCP ack awk script
  60 atm.h           - ATM traffic type definitions
  61 atmuni31.h      - ATM Q.2931 definitions
  62 bootp.h         - BOOTP definitions
  63 bpf_dump.c      - BPF program printing routines, in case libpcap doesn't
  64                   have them
  65 chdlc.h         - Cisco HDLC definitions
  66 config.guess    - autoconf support
  67 config.h.in     - autoconf input
  68 config.sub      - autoconf support
  69 configure       - configure script (run this first)
  70 configure.in    - configure script source
  71 decnet.h        - DECnet definitions
  72 enc.h           - OpenBSD IPsec encapsulation BPF layer definitions
  73 esp.h           - IPSEC Encapsulating Security Payload definitions
  74 ether.h         - Ethernet definitions
  75 ethertype.h     - Ethernet type value definitions
  76 extract.h       - alignment definitions
  77 fddi.h          - Fiber Distributed Data Interface definitions
  78 gmpls.c         - GMPLS definitions
  79 gmpls.h         - GMPLS declarations
  80 gmt2local.c     - time conversion routines
  81 gmt2local.h     - time conversion prototypes
  82 icmp6.h         - ICMPv6 definitiions
  83 ieee802_11.h    - IEEE 802.11 definitions
  84 igrp.h          - Interior Gateway Routing Protocol definitions
  85 install-sh      - BSD style install script
  86 interface.h     - globals, prototypes and definitions
  87 ip.h            - IP definitions
  88 ip6.h           - IPv6 definitions
  89 ipfc.h          - IP-over-Fibre Channel definitions
  90 ipproto.h       - IP protocol type value definitions
  91 ipsec_doi.h     - ISAKMP packet definitions - RFC2407
  92 ipx.h           - IPX definitions
  93 isakmp.h        - ISAKMP packet definitions - RFC2408
  94 l2tp.h          - Layer Two Tunneling Protocol definitions
  95 lane.h          - ATM LANE definitions
  96 lbl/os-*.h      - OS-dependent defines and prototypes
  97 llc.h           - LLC definitions
  98 machdep.c       - machine dependent routines
  99 machdep.h       - machine dependent definitions
 100 makemib         - mib to header script
 101 mib.h           - mib definitions
 102 missing/*       - replacements for missing library functions
 103 mkdep           - construct Makefile dependency list
 104 nameser.h       - DNS definitions
 105 netbios.h       - NETBIOS definitions
 106 nfs.h           - Network File System V2 definitions
 107 nfsfh.h         - Network File System file handle definitions
 108 ntp.h           - Network Time Protocol definitions
 109 oakley.h        - ISAKMP packet definitions - RFC2409
 110 ospf.h          - Open Shortest Path First definitions
 111 ospf6.h         - IPv6 Open Shortest Path First definitions
 112 packetdat.awk   - TCP chunk summary awk script
 113 parsenfsfh.c    - Network File System file parser routines
 114 pcap-missing.h  - declarations of functions possibly missing from libpcap
 115 ppp.h           - Point to Point Protocol definitions
 116 print-802_11.c  - IEEE 802.11 printer routines
 117 print-ap1394.c  - Apple IP-over-IEEE 1394 printer routines
 118 print-ah.c      - IPSEC Authentication Header printer routines
 119 print-aodv.c    - AODV printer routines
 120 print-arcnet.c  - ARCNET printer routines
 121 print-arp.c     - Address Resolution Protocol printer routines
 122 print-ascii.c   - ASCII packet dump routines
 123 print-atalk.c   - AppleTalk printer routines
 124 print-atm.c     - ATM printer routines
 125 print-bgp.c     - Border Gateway Protocol printer routines
 126 print-bootp.c   - BOOTP and IPv4 DHCP printer routines
 127 print-beep.c    - BEEP printer routines
 128 print-cdp.c     - Cisco Discovery Protocol printer routines
 129 print-chdlc.c   - Cisco HDLC printer routines
 130 print-cip.c     - Classical-IP over ATM routines
 131 print-cnfp.c    - Cisco NetFlow printer routines
 132 print-decnet.c  - DECnet printer routines
 133 print-dhcp6.c   - IPv6 DHCP printer routines
 134 print-domain.c  - Domain Name System printer routines
 135 print-dvmrp.c   - Distance Vector Multicast Routing Protocol printer routines
 136 print-enc.c     - OpenBSD IPsec encapsulation BPF layer printer routines
 137 print-egp.c     - External Gateway Protocol printer routines
 138 print-esp.c     - IPSEC Encapsulating Security Payload printer routines
 139 print-ether.c   - Ethernet printer routines
 140 print-fddi.c    - Fiber Distributed Data Interface printer routines
 141 print-fr.c      - Frame Relay printer routines
 142 print-frag6.c   - IPv6 fragmentation header printer routines
 143 print-gre.c     - Generic Routing Encapsulation printer routines
 144 print-hsrp.c    - Cisco Hot Standby Router Protocol printer routines
 145 print-icmp.c    - Internet Control Message Protocol printer routines
 146 print-icmp6.c   - IPv6 Internet Control Message Protocol printer routines
 147 print-igmp.c    - Internet Group Management Protocol printer routines
 148 print-igrp.c    - Interior Gateway Routing Protocol printer routines
 149 print-ip.c      - IP printer routines
 150 print-ip6.c     - IPv6 printer routines
 151 print-ip6opts.c - IPv6 header option printer routines
 152 print-ipcomp.c  - IP Payload Compression Protocol printer routines
 153 print-ipx.c     - IPX printer routines
 154 print-isakmp.c  - Internet Security Association and Key Management Protocol
 155 print-isoclns.c - ISO CLNS, ESIS, and ISIS printer routines
 156 print-krb.c     - Kerberos printer routines
 157 print-l2tp.c    - Layer Two Tunneling Protocol printer routines
 158 print-lane.c    - ATM LANE printer routines
 159 print-llc.c     - IEEE 802.2 LLC printer routines
 160 print-lwres.c   - Lightweight Resolver protocol printer routines
 161 print-mobile.c  - IPv4 mobility printer routines
 162 print-mobility.c - IPv6 mobility printer routines
 163 print-mpls.c    - Multi-Protocol Label Switching printer routines
 164 print-msdp.c    - Multicast Source Discovery Protocol printer routines
 165 print-netbios.c - NetBIOS frame protocol printer routines
 166 print-nfs.c     - Network File System printer routines
 167 print-ntp.c     - Network Time Protocol printer routines
 168 print-null.c    - BSD loopback device printer routines
 169 print-ospf.c    - Open Shortest Path First printer routines
 170 print-ospf6.c   - IPv6 Open Shortest Path First printer routines
 171 print-pflog.c   - OpenBSD packet filter log file printer routines
 172 print-pim.c     - Protocol Independent Multicast printer routines
 173 print-ppp.c     - Point to Point Protocol printer routines
 174 print-pppoe.c   - PPP-over-Ethernet printer routines
 175 print-pptp.c    - Point-to-Point Tunnelling Protocol printer routines
 176 print-radius.c  - Radius protocol printer routines
 177 print-raw.c     - Raw IP printer routines
 178 print-rip.c     - Routing Information Protocol printer routines
 179 print-ripng.c   - IPv6 Routing Information Protocol printer routines
 180 print-rsvp.c    - Resource reSerVation Protocol (RSVP) printer routines
 181 print-rt6.c     - IPv6 routing header printer routines
 182 print-rx.c      - AFS RX printer routines
 183 print-sctp.c    - Stream Control Transmission Protocol printer routines
 184 print-sl.c      - Compressed Serial Line Internet Protocol printer routines
 185 print-sll.c     - Linux "cooked" capture printer routines
 186 print-smb.c     - SMB/CIFS printer routines
 187 print-snmp.c    - Simple Network Management Protocol printer routines
 188 print-stp.c     - IEEE 802.1d spanning tree protocol printer routines
 189 print-sunatm.c  - SunATM DLPI capture printer routines
 190 print-sunrpc.c  - Sun Remote Procedure Call printer routines
 191 print-tcp.c     - TCP printer routines
 192 print-telnet.c  - Telnet option printer routines
 193 print-tftp.c    - Trivial File Transfer Protocol printer routines
 194 print-timed.c   - BSD time daemon protocol printer routines
 195 print-token.c   - Token Ring printer routines
 196 print-udp.c     - UDP printer routines
 197 print-vjc.c     - PPP Van Jacobson compression (RFC1144) printer routines
 198 print-vrrp.c    - Virtual Router Redundancy Protocol
 199 print-wb.c      - White Board printer routines
 200 print-zephyr.c  - Zephyr printer routines
 201 route6d.h       - packet definition for IPv6 Routing Information Protocol
 202 rx.h            - AFS RX definitions
 203 sctpConstants.h - Stream Control Transmission Protocol constant definitions
 204 sctpHeader.h    - Stream Control Transmission Protocol packet definitions
 205 send-ack.awk    - unidirectional tcp send/ack awk script
 206 setsignal.c     - OS-independent signal routines
 207 setsignal.h     - OS-independent signal prototypes
 208 slcompress.h    - SLIP/PPP Van Jacobson compression (RFC1144) definitions
 209 slip.h          - SLIP definitions
 210 sll.h           - Linux "cooked" capture definitions
 211 smb.h           - SMB/CIFS definitions
 212 smbutil.c       - SMB/CIFS utility routines
 213 stime.awk       - TCP send awk script
 214 strcasecmp.c    - missing routine
 215 tcp.h           - TCP definitions
 216 tcpdump.1       - manual entry
 217 tcpdump.c       - main program
 218 telnet.h        - Telnet definitions
 219 timed.h         - BSD time daemon protocol definitions
 220 token.h         - Token Ring definitions
 221 udp.h           - UDP definitions
 222 util.c          - utility routines
 223 vfprintf.c      - emulation routine
 224 win32           - headers and routines for building on Win32 systems