1@(#) $Header: /tcpdump/master/tcpdump/INSTALL,v 1.63.2.7 2007/09/14 01:03:12 guy Exp $ (LBL) 2 3If you have not built libpcap, and your system does not have libpcap 4installed, install libpcap first. Your system might provide a version 5of libpcap that can be installed; if so, to compile tcpdump you might 6need to install a "developer" version of libpcap as well as the 7"run-time" version. You can also install tcpdump.org's version of 8libpcap; see the README file in this directory for the ftp location. 9 10You will need an ANSI C compiler to build tcpdump. The configure script 11will abort if your compiler is not ANSI compliant. If this happens, use 12the GNU C compiler, available via anonymous ftp: 13 14 ftp://ftp.gnu.org/pub/gnu/gcc/ 15 16After libpcap has been built (either install it with "make install" or 17make sure both the libpcap and tcpdump source trees are in the same 18directory), run ./configure (a shell script). "configure" will 19determine your system attributes and generate an appropriate Makefile 20from Makefile.in. Now build tcpdump by running "make". 21 22If everything builds ok, su and type "make install". This will install 23tcpdump and the manual entry. Any user will be able to use tcpdump to 24read saved captures. Whether a user will be able to capture traffic 25depends on the OS and the configuration of the system; see the tcpdump 26man page for details. DO NOT give untrusted users the ability to 27capture traffic. If a user can capture traffic, he or she could use 28utilities such as tcpdump to capture any traffic on your net, including 29passwords. 30 31Note that most systems ship tcpdump, but usually an older version. 32Remember to remove or rename the installed binary when upgrading. 33 34If your system is not one which we have tested tcpdump on, you may have 35to modify the configure script and Makefile.in. Please send us patches 36for any modifications you need to make. 37 38Please see "PLATFORMS" for notes about tested platforms. 39 40 41FILES 42----- 43CHANGES - description of differences between releases 44CREDITS - people that have helped tcpdump along 45FILES - list of files exported as part of the distribution 46INSTALL - this file 47LICENSE - the license under which tcpdump is distributed 48Makefile.in - compilation rules (input to the configure script) 49README - description of distribution 50Readme.Win32 - notes on building tcpdump on Win32 systems (with WinPcap) 51VERSION - version of this release 52acconfig.h - autoconf input 53aclocal.m4 - autoconf macros 54addrtoname.c - address to hostname routines 55addrtoname.h - address to hostname definitions 56ah.h - IPSEC Authentication Header definitions 57aodv.h - AODV definitions 58appletalk.h - AppleTalk definitions 59arcnet.h - ARCNET definitions 60atime.awk - TCP ack awk script 61atm.h - ATM traffic type definitions 62atmuni31.h - ATM Q.2931 definitions 63bgp.h - BGP declarations 64bootp.h - BOOTP definitions 65bpf_dump.c - BPF program printing routines, in case libpcap doesn't 66 have them 67chdlc.h - Cisco HDLC definitions 68cpack.c - functions to extract packed data 69cpack.h - declarations of functions to extract packed data 70config.guess - autoconf support 71config.h.in - autoconf input 72config.sub - autoconf support 73configure - configure script (run this first) 74configure.in - configure script source 75dccp.h - DCCP definitions 76decnet.h - DECnet definitions 77decode_prefix.h - Declarations of "decode_prefix{4,6}()" 78enc.h - OpenBSD IPsec encapsulation BPF layer definitions 79esp.h - IPSEC Encapsulating Security Payload definitions 80ether.h - Ethernet definitions 81ethertype.h - Ethernet type value definitions 82extract.h - alignment definitions 83fddi.h - Fiber Distributed Data Interface definitions 84gmpls.c - GMPLS definitions 85gmpls.h - GMPLS declarations 86gmt2local.c - time conversion routines 87gmt2local.h - time conversion prototypes 88icmp6.h - ICMPv6 definitiions 89ieee802_11.h - IEEE 802.11 definitions 90ieee802_11_radio.h - radiotap header definitions 91igrp.h - Interior Gateway Routing Protocol definitions 92install-sh - BSD style install script 93interface.h - globals, prototypes and definitions 94ip.h - IP definitions 95ip6.h - IPv6 definitions 96ipfc.h - IP-over-Fibre Channel definitions 97ipproto.c - IP protocol type value-to-name table 98ipproto.h - IP protocol type value definitions 99ipsec_doi.h - ISAKMP packet definitions - RFC2407 100ipx.h - IPX definitions 101isakmp.h - ISAKMP packet definitions - RFC2408 102l2vpn.c - L2VPN encapsulation value-to-name table 103l2vpn.h - L2VPN encapsulation definitions 104l2tp.h - Layer Two Tunneling Protocol definitions 105lane.h - ATM LANE definitions 106lbl/os-*.h - OS-dependent defines and prototypes 107llc.h - LLC definitions 108machdep.c - machine dependent routines 109machdep.h - machine dependent definitions 110makemib - mib to header script 111mib.h - mib definitions 112missing/* - replacements for missing library functions 113mkdep - construct Makefile dependency list 114mpls.h - MPLS definitions 115nameser.h - DNS definitions 116netbios.h - NETBIOS definitions 117netdissect.h - definitions and declarations for tcpdump-as-library 118 (under development) 119nfs.h - Network File System V2 definitions 120nfsfh.h - Network File System file handle definitions 121nlpid.c - OSI NLPID value-to-name table 122nlpid.h - OSI NLPID definitions 123ntp.h - Network Time Protocol definitions 124oakley.h - ISAKMP packet definitions - RFC2409 125ospf.h - Open Shortest Path First definitions 126ospf6.h - IPv6 Open Shortest Path First definitions 127packetdat.awk - TCP chunk summary awk script 128parsenfsfh.c - Network File System file parser routines 129pcap_dump_ftell.c - pcap_dump_ftell() implementation, in case libpcap 130 doesn't have it 131pcap-missing.h - declarations of functions possibly missing from libpcap 132pmap_prot.h - definitions for ONC RPC portmapper protocol 133ppp.h - Point to Point Protocol definitions 134print-802_11.c - IEEE 802.11 printer routines 135print-ap1394.c - Apple IP-over-IEEE 1394 printer routines 136print-ah.c - IPSEC Authentication Header printer routines 137print-aodv.c - AODV printer routines 138print-arcnet.c - ARCNET printer routines 139print-arp.c - Address Resolution Protocol printer routines 140print-ascii.c - ASCII packet dump routines 141print-atalk.c - AppleTalk printer routines 142print-atm.c - ATM printer routines 143print-bgp.c - Border Gateway Protocol printer routines 144print-bootp.c - BOOTP and IPv4 DHCP printer routines 145print-beep.c - BEEP printer routines 146print-cdp.c - Cisco Discovery Protocol printer routines 147print-chdlc.c - Cisco HDLC printer routines 148print-cip.c - Classical-IP over ATM routines 149print-cnfp.c - Cisco NetFlow printer routines 150print-dccp.c - DCCP printer routines 151print-decnet.c - DECnet printer routines 152print-dhcp6.c - IPv6 DHCP printer routines 153print-domain.c - Domain Name System printer routines 154print-dvmrp.c - Distance Vector Multicast Routing Protocol printer routines 155print-eap.c - EAP printer routines 156print-enc.c - OpenBSD IPsec encapsulation BPF layer printer routines 157print-egp.c - External Gateway Protocol printer routines 158print-esp.c - IPSEC Encapsulating Security Payload printer routines 159print-ether.c - Ethernet printer routines 160print-fddi.c - Fiber Distributed Data Interface printer routines 161print-fr.c - Frame Relay printer routines 162print-frag6.c - IPv6 fragmentation header printer routines 163print-gre.c - Generic Routing Encapsulation printer routines 164print-hsrp.c - Cisco Hot Standby Router Protocol printer routines 165print-icmp.c - Internet Control Message Protocol printer routines 166print-icmp6.c - IPv6 Internet Control Message Protocol printer routines 167print-igmp.c - Internet Group Management Protocol printer routines 168print-igrp.c - Interior Gateway Routing Protocol printer routines 169print-ip.c - IP printer routines 170print-ip6.c - IPv6 printer routines 171print-ip6opts.c - IPv6 header option printer routines 172print-ipcomp.c - IP Payload Compression Protocol printer routines 173print-ipx.c - IPX printer routines 174print-isakmp.c - Internet Security Association and Key Management Protocol 175print-isoclns.c - ISO CLNS, ESIS, and ISIS printer routines 176print-krb.c - Kerberos printer routines 177print-l2tp.c - Layer Two Tunneling Protocol printer routines 178print-lane.c - ATM LANE printer routines 179print-llc.c - IEEE 802.2 LLC printer routines 180print-lspping.c - LSPPING printer routines 181print-lwres.c - Lightweight Resolver protocol printer routines 182print-mobile.c - IPv4 mobility printer routines 183print-mobility.c - IPv6 mobility printer routines 184print-mpls.c - Multi-Protocol Label Switching printer routines 185print-msdp.c - Multicast Source Discovery Protocol printer routines 186print-netbios.c - NetBIOS frame protocol printer routines 187print-nfs.c - Network File System printer routines 188print-ntp.c - Network Time Protocol printer routines 189print-null.c - BSD loopback device printer routines 190print-ospf.c - Open Shortest Path First printer routines 191print-ospf6.c - IPv6 Open Shortest Path First printer routines 192print-pflog.c - OpenBSD packet filter log file printer routines 193print-pgm.c - Pragmatic General Multicast printer routines 194print-pim.c - Protocol Independent Multicast printer routines 195print-ppp.c - Point to Point Protocol printer routines 196print-pppoe.c - PPP-over-Ethernet printer routines 197print-pptp.c - Point-to-Point Tunnelling Protocol printer routines 198print-radius.c - Radius protocol printer routines 199print-raw.c - Raw IP printer routines 200print-rip.c - Routing Information Protocol printer routines 201print-ripng.c - IPv6 Routing Information Protocol printer routines 202print-rsvp.c - Resource reSerVation Protocol (RSVP) printer routines 203print-rt6.c - IPv6 routing header printer routines 204print-rx.c - AFS RX printer routines 205print-sctp.c - Stream Control Transmission Protocol printer routines 206print-sip.c - SIP printer routines 207print-sl.c - Compressed Serial Line Internet Protocol printer routines 208print-sll.c - Linux "cooked" capture printer routines 209print-slow.c - IEEE "slow protocol" (802.3ad) printer routines 210print-smb.c - SMB/CIFS printer routines 211print-snmp.c - Simple Network Management Protocol printer routines 212print-stp.c - IEEE 802.1d spanning tree protocol printer routines 213print-sunatm.c - SunATM DLPI capture printer routines 214print-sunrpc.c - Sun Remote Procedure Call printer routines 215print-symantec.c - Symantec Enterprise Firewall printer routines 216print-tcp.c - TCP printer routines 217print-telnet.c - Telnet option printer routines 218print-tftp.c - Trivial File Transfer Protocol printer routines 219print-timed.c - BSD time daemon protocol printer routines 220print-token.c - Token Ring printer routines 221print-udp.c - UDP printer routines 222print-vjc.c - PPP Van Jacobson compression (RFC1144) printer routines 223print-vrrp.c - Virtual Router Redundancy Protocol 224print-wb.c - White Board printer routines 225print-zephyr.c - Zephyr printer routines 226route6d.h - packet definition for IPv6 Routing Information Protocol 227rpc_auth.h - definitions for ONC RPC authentication 228rpc_msg.h - definitions for ONC RPC messages 229rx.h - AFS RX definitions 230sctpConstants.h - Stream Control Transmission Protocol constant definitions 231sctpHeader.h - Stream Control Transmission Protocol packet definitions 232send-ack.awk - unidirectional tcp send/ack awk script 233setsignal.c - OS-independent signal routines 234setsignal.h - OS-independent signal prototypes 235slcompress.h - SLIP/PPP Van Jacobson compression (RFC1144) definitions 236slip.h - SLIP definitions 237sll.h - Linux "cooked" capture definitions 238smb.h - SMB/CIFS definitions 239smbutil.c - SMB/CIFS utility routines 240stime.awk - TCP send awk script 241strcasecmp.c - missing routine 242tcp.h - TCP definitions 243tcpdump.1 - manual entry 244tcpdump.c - main program 245telnet.h - Telnet definitions 246tftp.h - TFTP definitions 247timed.h - BSD time daemon protocol definitions 248token.h - Token Ring definitions 249udp.h - UDP definitions 250util.c - utility routines 251vfprintf.c - emulation routine 252win32 - headers and routines for building on Win32 systems 253