1@(#) $Header: /home/cvs/src/usr.sbin/tcpdump/INSTALL,v 1.1 1996/12/12 16:23:03 bitblt Exp $ (LBL) 2 3If you have not built libpcap, do so first. See the README 4file in this directory for the ftp location. 5 6You will need an ANSI C compiler to build tcpdump. The configure script 7will abort if your compiler is not ANSI compliant. If this happens, use 8the GNU C compiler, available via anonymous ftp: 9 10 ftp://prep.ai.mit.edu/pub/gnu/gcc.tar.gz 11 12After libpcap has been built (either install it with "make install" and 13"make install-incl" or make sure both the libpcap and tcpdump source 14trees are in the same directory), edit the BINDEST and MANDEST paths in 15Makefile.in and run ./configure (a shell script). "configure" will 16determine your system attributes and generate an appropriate Makefile 17from Makefile.in. Now build tcpdump by running "make". 18 19If everything builds ok, su and type "make install" (and optionally 20"make install-man). This will install tcpdump and the manual entry. By 21default, tcpdump is installed with group execute permissions. The group 22used depends on your os. In addition, BPF packet access is controlled 23by permissions to /dev/bpf0. In any case, DO NOT give untrusted users 24the capability of running tcpdump. Tcpdump can capture any traffic on 25your net, including passwords. 26 27Note that tcpdump is shipped with some systems, for example, DEC/OSF 28and BSD/386. Remember to remove or rename the installed binary 29when upgrading. 30 31If you use OSF 4, note that that there appears to be some serious bugs 32with the stock C compiler. The configure code fragments that detect if 33the ether_header and ether_arp structs use the ether_addr struct 34generates warnings instead of fatal errors (?!?!) This makes configure 35think that the ether_arp struct is used when in fact it is not. To get 36around this, delete: 37 38 -DETHER_HEADER_HAS_EA=1 -DETHER_ARP_HAS_EA=1 39 40from the Makefile after running configure (and before attempting to 41compile tcpdump. 42 43Another workaround is to use gcc. 44 45If your system is not one which we have tested tcpdump on, you may have 46to modify the configure script and Makefile.in. Please send us patches 47for any modifications you need to make. However, we are not interested 48in ascii packet printer patches. We believe adding this feature would 49make it too easy for crackers who do not have the programming skills 50needed to write a password sniffer to grab clear text passwords. 51 52FILES 53----- 54CHANGES - description of differences between releases 55FILES - list of files exported as part of the distribution 56INSTALL - this file 57Makefile.in - compilation rules (input to the configure script) 58README - description of distribution 59VERSION - version of this release 60acsite.m4 - autoconf macros 61addrtoname.c - address to hostname routines 62addrtoname.h - address to hostname definitions 63appletalk.h - AppleTalk definitions 64atime.awk - TCP ack awk script 65bootp.h - BOOTP definitions 66bpf_dump.c - bpf instruction pretty-printer routine 67config.guess - autoconf support 68config.sub - autoconf support 69configure - configure script (run this first) 70configure.in - configure script source 71decnet.h - DECnet definitions 72ethertype.h - ethernet definitions 73extract.h - alignment definitions 74fddi.h - Fiber Distributed Data Interface definitions 75igrp.h - Interior Gateway Routing Protocol definitions 76install-sh - BSD style install script 77interface.h - globals, prototypes and definitions 78ipx.h - IPX definitions 79lbl/gnuc.h - gcc macros and defines 80lbl/os-*.h - os dependent defines and prototypes 81linux-include/* - network include files missing on Linux 82llc.h - LLC definitions 83machdep.c - machine dependent routines 84machdep.h - machine dependent definitions 85makemib - mib to header script 86mib.h - mib definitions 87mkdep - construct Makefile dependency list 88netbios.h - NETBIOS definitions 89nfsfh.h - Network File System file handle definitions 90nfsv2.h - Network File System V2 definitions 91ntp.h - Network Time Protocol definitions 92ospf.h - Open Shortest Path First definitions 93packetdat.awk - TCP chunk summary awk script 94parsenfsfh.c - Network File System file parser routines 95print-arp.c - Address Resolution Protocol printer routines 96print-atalk.c - AppleTalk printer routines 97print-atm.c - atm printer routines 98print-bootp.c - BOOTP printer routines 99print-decnet.c - DECnet printer routines 100print-domain.c - Domain Name System printer routines 101print-egp.c - External Gateway Protocol printer routines 102print-ether.c - ethernet printer routines 103print-fddi.c - Fiber Distributed Data Interface printer routines 104print-gre.c - Generic Routing Encapsulation printer routines 105print-icmp.c - Internet Control Message Protocol printer routines 106print-igrp.c - Interior Gateway Routing Protocol printer routines 107print-ip.c - ip printer routines 108print-ipx.c - IPX printer routines 109print-isoclns.c - isoclns printer routines 110print-krb.c - Kerberos printer routines 111print-llc.c - llc printer routines 112print-netbios.c - netbios printer routines 113print-nfs.c - Network File System printer routines 114print-ntp.c - Network Time Protocol printer routines 115print-null.c - null printer routines 116print-ospf.c - Open Shortest Path First printer routines 117print-pim.c - Protocol Independent Multicast printer routines 118print-ppp.c - Point to Point Protocol printer routines 119print-rip.c - Routing Information Protocol printer routines 120print-sl.c - Compressed Serial Line Internet Protocol printer routines 121print-snmp.c - Simple Network Management Protocol printer routines 122print-sunrpc.c - Sun Remote Procedure Call printer routines 123print-tcp.c - TCP printer routines 124print-tftp.c - Trivial File Transfer Protocol printer routines 125print-udp.c - UDP printer routines 126print-wb.c - white board printer routines 127send-ack.awk - unidirectional tcp send/ack awk script 128stime.awk - TCP send awk script 129tcpdump.1 - manual entry 130tcpdump.c - main program 131util.c - utility routines 132vfprintf.c - emulation routine 133