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