contrib/tcpdump/INSTALL

   1 @(#) $Header: /tcpdump/master/tcpdump/INSTALL,v 1.63.2.4 2005/09/20 06:05:35 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 bgp.h           - BGP declarations
  63 bootp.h         - BOOTP definitions
  64 bpf_dump.c      - BPF program printing routines, in case libpcap doesn't
  65                   have them
  66 chdlc.h         - Cisco HDLC definitions
  67 cpack.c         - functions to extract packed data
  68 cpack.h         - declarations of functions to extract packed data
  69 config.guess    - autoconf support
  70 config.h.in     - autoconf input
  71 config.sub      - autoconf support
  72 configure       - configure script (run this first)
  73 configure.in    - configure script source
  74 dccp.h          - DCCP definitions
  75 decnet.h        - DECnet definitions
  76 decode_prefix.h - Declarations of "decode_prefix{4,6}()"
  77 enc.h           - OpenBSD IPsec encapsulation BPF layer definitions
  78 esp.h           - IPSEC Encapsulating Security Payload definitions
  79 ether.h         - Ethernet definitions
  80 ethertype.h     - Ethernet type value definitions
  81 extract.h       - alignment definitions
  82 fddi.h          - Fiber Distributed Data Interface definitions
  83 gmpls.c         - GMPLS definitions
  84 gmpls.h         - GMPLS declarations
  85 gmt2local.c     - time conversion routines
  86 gmt2local.h     - time conversion prototypes
  87 icmp6.h         - ICMPv6 definitiions
  88 ieee802_11.h    - IEEE 802.11 definitions
  89 ieee802_11_radio.h - radiotap header definitions
  90 igrp.h          - Interior Gateway Routing Protocol definitions
  91 install-sh      - BSD style install script
  92 interface.h     - globals, prototypes and definitions
  93 ip.h            - IP definitions
  94 ip6.h           - IPv6 definitions
  95 ipfc.h          - IP-over-Fibre Channel definitions
  96 ipproto.c       - IP protocol type value-to-name table
  97 ipproto.h       - IP protocol type value definitions
  98 ipsec_doi.h     - ISAKMP packet definitions - RFC2407
  99 ipx.h           - IPX definitions
 100 isakmp.h        - ISAKMP packet definitions - RFC2408
 101 l2vpn.c         - L2VPN encapsulation value-to-name table
 102 l2vpn.h         - L2VPN encapsulation definitions
 103 l2tp.h          - Layer Two Tunneling Protocol definitions
 104 lane.h          - ATM LANE definitions
 105 lbl/os-*.h      - OS-dependent defines and prototypes
 106 llc.h           - LLC definitions
 107 machdep.c       - machine dependent routines
 108 machdep.h       - machine dependent definitions
 109 makemib         - mib to header script
 110 mib.h           - mib definitions
 111 missing/*       - replacements for missing library functions
 112 mkdep           - construct Makefile dependency list
 113 mpls.h          - MPLS definitions
 114 nameser.h       - DNS definitions
 115 netbios.h       - NETBIOS definitions
 116 netdissect.h    - definitions and declarations for tcpdump-as-library
 117                   (under development)
 118 nfs.h           - Network File System V2 definitions
 119 nfsfh.h         - Network File System file handle definitions
 120 nlpid.c         - OSI NLPID value-to-name table
 121 nlpid.h         - OSI NLPID definitions
 122 ntp.h           - Network Time Protocol definitions
 123 oakley.h        - ISAKMP packet definitions - RFC2409
 124 ospf.h          - Open Shortest Path First definitions
 125 ospf6.h         - IPv6 Open Shortest Path First definitions
 126 packetdat.awk   - TCP chunk summary awk script
 127 parsenfsfh.c    - Network File System file parser routines
 128 pcap_dump_ftell.c - pcap_dump_ftell() implementation, in case libpcap
 129                 doesn't have it
 130 pcap-missing.h  - declarations of functions possibly missing from libpcap
 131 pf.h            - OpenBSD PF definitions
 132 pmap_prot.h     - definitions for ONC RPC portmapper protocol
 133 ppp.h           - Point to Point Protocol definitions
 134 print-802_11.c  - IEEE 802.11 printer routines
 135 print-ap1394.c  - Apple IP-over-IEEE 1394 printer routines
 136 print-ah.c      - IPSEC Authentication Header printer routines
 137 print-aodv.c    - AODV printer routines
 138 print-arcnet.c  - ARCNET printer routines
 139 print-arp.c     - Address Resolution Protocol printer routines
 140 print-ascii.c   - ASCII packet dump routines
 141 print-atalk.c   - AppleTalk printer routines
 142 print-atm.c     - ATM printer routines
 143 print-bgp.c     - Border Gateway Protocol printer routines
 144 print-bootp.c   - BOOTP and IPv4 DHCP printer routines
 145 print-beep.c    - BEEP printer routines
 146 print-cdp.c     - Cisco Discovery Protocol printer routines
 147 print-chdlc.c   - Cisco HDLC printer routines
 148 print-cip.c     - Classical-IP over ATM routines
 149 print-cnfp.c    - Cisco NetFlow printer routines
 150 print-dccp.c    - DCCP printer routines
 151 print-decnet.c  - DECnet printer routines
 152 print-dhcp6.c   - IPv6 DHCP printer routines
 153 print-domain.c  - Domain Name System printer routines
 154 print-dvmrp.c   - Distance Vector Multicast Routing Protocol printer routines
 155 print-eap.c     - EAP printer routines
 156 print-enc.c     - OpenBSD IPsec encapsulation BPF layer printer routines
 157 print-egp.c     - External Gateway Protocol printer routines
 158 print-esp.c     - IPSEC Encapsulating Security Payload printer routines
 159 print-ether.c   - Ethernet printer routines
 160 print-fddi.c    - Fiber Distributed Data Interface printer routines
 161 print-fr.c      - Frame Relay printer routines
 162 print-frag6.c   - IPv6 fragmentation header printer routines
 163 print-gre.c     - Generic Routing Encapsulation printer routines
 164 print-hsrp.c    - Cisco Hot Standby Router Protocol printer routines
 165 print-icmp.c    - Internet Control Message Protocol printer routines
 166 print-icmp6.c   - IPv6 Internet Control Message Protocol printer routines
 167 print-igmp.c    - Internet Group Management Protocol printer routines
 168 print-igrp.c    - Interior Gateway Routing Protocol printer routines
 169 print-ip.c      - IP printer routines
 170 print-ip6.c     - IPv6 printer routines
 171 print-ip6opts.c - IPv6 header option printer routines
 172 print-ipcomp.c  - IP Payload Compression Protocol printer routines
 173 print-ipx.c     - IPX printer routines
 174 print-isakmp.c  - Internet Security Association and Key Management Protocol
 175 print-isoclns.c - ISO CLNS, ESIS, and ISIS printer routines
 176 print-krb.c     - Kerberos printer routines
 177 print-l2tp.c    - Layer Two Tunneling Protocol printer routines
 178 print-lane.c    - ATM LANE printer routines
 179 print-llc.c     - IEEE 802.2 LLC printer routines
 180 print-lspping.c - LSPPING printer routines
 181 print-lwres.c   - Lightweight Resolver protocol printer routines
 182 print-mobile.c  - IPv4 mobility printer routines
 183 print-mobility.c - IPv6 mobility printer routines
 184 print-mpls.c    - Multi-Protocol Label Switching printer routines
 185 print-msdp.c    - Multicast Source Discovery Protocol printer routines
 186 print-netbios.c - NetBIOS frame protocol printer routines
 187 print-nfs.c     - Network File System printer routines
 188 print-ntp.c     - Network Time Protocol printer routines
 189 print-null.c    - BSD loopback device printer routines
 190 print-ospf.c    - Open Shortest Path First printer routines
 191 print-ospf6.c   - IPv6 Open Shortest Path First printer routines
 192 print-pflog.c   - OpenBSD packet filter log file printer routines
 193 print-pgm.c     - Pragmatic General Multicast printer routines
 194 print-pim.c     - Protocol Independent Multicast printer routines
 195 print-ppp.c     - Point to Point Protocol printer routines
 196 print-pppoe.c   - PPP-over-Ethernet printer routines
 197 print-pptp.c    - Point-to-Point Tunnelling Protocol printer routines
 198 print-radius.c  - Radius protocol printer routines
 199 print-raw.c     - Raw IP printer routines
 200 print-rip.c     - Routing Information Protocol printer routines
 201 print-ripng.c   - IPv6 Routing Information Protocol printer routines
 202 print-rsvp.c    - Resource reSerVation Protocol (RSVP) printer routines
 203 print-rt6.c     - IPv6 routing header printer routines
 204 print-rx.c      - AFS RX printer routines
 205 print-sctp.c    - Stream Control Transmission Protocol printer routines
 206 print-sip.c     - SIP printer routines
 207 print-sl.c      - Compressed Serial Line Internet Protocol printer routines
 208 print-sll.c     - Linux "cooked" capture printer routines
 209 print-slow.c    - IEEE "slow protocol" (802.3ad) printer routines
 210 print-smb.c     - SMB/CIFS printer routines
 211 print-snmp.c    - Simple Network Management Protocol printer routines
 212 print-stp.c     - IEEE 802.1d spanning tree protocol printer routines
 213 print-sunatm.c  - SunATM DLPI capture printer routines
 214 print-sunrpc.c  - Sun Remote Procedure Call printer routines
 215 print-symantec.c - Symantec Enterprise Firewall printer routines
 216 print-tcp.c     - TCP printer routines
 217 print-telnet.c  - Telnet option printer routines
 218 print-tftp.c    - Trivial File Transfer Protocol printer routines
 219 print-timed.c   - BSD time daemon protocol printer routines
 220 print-token.c   - Token Ring printer routines
 221 print-udp.c     - UDP printer routines
 222 print-vjc.c     - PPP Van Jacobson compression (RFC1144) printer routines
 223 print-vrrp.c    - Virtual Router Redundancy Protocol
 224 print-wb.c      - White Board printer routines
 225 print-zephyr.c  - Zephyr printer routines
 226 route6d.h       - packet definition for IPv6 Routing Information Protocol
 227 rpc_auth.h      - definitions for ONC RPC authentication
 228 rpc_msg.h       - definitions for ONC RPC messages
 229 rx.h            - AFS RX definitions
 230 sctpConstants.h - Stream Control Transmission Protocol constant definitions
 231 sctpHeader.h    - Stream Control Transmission Protocol packet definitions
 232 send-ack.awk    - unidirectional tcp send/ack awk script
 233 setsignal.c     - OS-independent signal routines
 234 setsignal.h     - OS-independent signal prototypes
 235 slcompress.h    - SLIP/PPP Van Jacobson compression (RFC1144) definitions
 236 slip.h          - SLIP definitions
 237 sll.h           - Linux "cooked" capture definitions
 238 smb.h           - SMB/CIFS definitions
 239 smbutil.c       - SMB/CIFS utility routines
 240 stime.awk       - TCP send awk script
 241 strcasecmp.c    - missing routine
 242 tcp.h           - TCP definitions
 243 tcpdump.1       - manual entry
 244 tcpdump.c       - main program
 245 telnet.h        - Telnet definitions
 246 timed.h         - BSD time daemon protocol definitions
 247 token.h         - Token Ring definitions
 248 udp.h           - UDP definitions
 249 util.c          - utility routines
 250 vfprintf.c      - emulation routine
 251 win32           - headers and routines for building on Win32 systems