contrib/tcpdump/INSTALL

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