The Tcpdump Group git mirrors - tcpdump/blob - INSTALL.txt

   1 If you have not built libpcap, and your system does not have libpcap
   2 installed, install libpcap first.  Your system might provide a version
   3 of libpcap that can be installed; if so, to compile tcpdump you might
   4 need to install a "developer" version of libpcap as well as the
   5 "run-time" version.  You can also install tcpdump.org's version of
   6 libpcap; see the README.md file in this directory for the location.
   7
   8 You will need a C99 compiler to build tcpdump.  The build system
   9 will abort if your compiler is not C99 compliant.  If this happens, use
  10 the generally available GNU C compiler (GCC) or Clang.
  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.  Any user will be able to use tcpdump to
  20 read saved captures.  Whether a user will be able to capture traffic
  21 depends on the OS and the configuration of the system; see the tcpdump
  22 man page for details.  DO NOT give untrusted users the ability to
  23 capture traffic.  If a user can capture traffic, he or she could use
  24 utilities such as tcpdump to capture any traffic on your net, including
  25 passwords.
  26
  27 Note that most systems ship tcpdump, but usually an older version.
  28 Building tcpdump from source as explained above will usually install the
  29 binary as "/usr/local/bin/tcpdump".  If your system has other tcpdump
  30 binaries, you might need to deinstall these or to set the PATH environment
  31 variable if you need the "tcpdump" command to run the new binary
  32 ("tcpdump --version" can be used to tell different versions apart).
  33
  34 If your system is not one which we have tested tcpdump on, you may have
  35 to modify the configure script and Makefile.in. Please send us patches
  36 for any modifications you need to make.
  37
  38 Please see "README.md" for notes about tested platforms.
  39
  40
  41 FILES
  42 -----
  43 CHANGES         - description of differences between releases
  44 CONTRIBUTING    - guidelines for contributing
  45 CREDITS         - people that have helped tcpdump along
  46 INSTALL.txt     - this file
  47 LICENSE         - the license under which tcpdump is distributed
  48 Makefile.in     - compilation rules (input to the configure script)
  49 README.md       - description of distribution
  50 Readme.Win32    - notes on building tcpdump on Win32 systems (with WinPcap)
  51 VERSION         - version of this release
  52 aclocal.m4      - autoconf macros
  53 addrtoname.c    - address to hostname routines
  54 addrtoname.h    - address to hostname definitions
  55 addrtostr.c     - address to printable string routines
  56 addrtostr.h     - address to printable string definitions
  57 ah.h            - IPSEC Authentication Header definitions
  58 appletalk.h     - AppleTalk definitions
  59 ascii_strcasecmp.c - locale-independent case-independent string comparison
  60                 routines
  61 atime.awk       - TCP ack awk script
  62 atm.h           - ATM traffic type definitions
  63 bpf_dump.c      - BPF program printing routines, in case libpcap doesn't
  64                   have them
  65 chdlc.h         - Cisco HDLC definitions
  66 cpack.c         - functions to extract packed data
  67 cpack.h         - declarations of functions to extract packed data
  68 config.guess    - autoconf support
  69 config.h.in     - autoconf input
  70 config.sub      - autoconf support
  71 configure       - configure script (run this first)
  72 configure.ac    - configure script source
  73 ethertype.h     - Ethernet type value definitions
  74 extract.h       - alignment definitions
  75 gmpls.c         - GMPLS definitions
  76 gmpls.h         - GMPLS declarations
  77 install-sh      - BSD style install script
  78 interface.h     - globals, prototypes and definitions
  79 ip.h            - IP definitions
  80 ip6.h           - IPv6 definitions
  81 ipproto.c       - IP protocol type value-to-name table
  82 ipproto.h       - IP protocol type value definitions
  83 l2vpn.c         - L2VPN encapsulation value-to-name table
  84 l2vpn.h         - L2VPN encapsulation definitions
  85 lbl/os-*.h      - OS-dependent defines and prototypes
  86 llc.h           - LLC definitions
  87 machdep.c       - machine dependent routines
  88 machdep.h       - machine dependent definitions
  89 makemib         - mib to header script
  90 mib.h           - mib definitions
  91 missing/*       - replacements for missing library functions
  92 ntp.c           - functions to handle ntp structs
  93 ntp.h           - declarations of functions to handle ntp structs
  94 mkdep           - construct Makefile dependency list
  95 mpls.h          - MPLS definitions
  96 nameser.h       - DNS definitions
  97 netdissect.h    - definitions and declarations for tcpdump-as-library
  98                   (under development)
  99 nfs.h           - Network File System V2 definitions
 100 nfsfh.h         - Network File System file handle definitions
 101 nlpid.c         - OSI NLPID value-to-name table
 102 nlpid.h         - OSI NLPID definitions
 103 ospf.h          - Open Shortest Path First definitions
 104 packetdat.awk   - TCP chunk summary awk script
 105 parsenfsfh.c    - Network File System file parser routines
 106 pcap-missing.h  - declarations of functions possibly missing from libpcap
 107 ppp.h           - Point to Point Protocol definitions
 108 print.c         - Top-level routines for protocol printing
 109 print-*.c       - The netdissect printers
 110 rpc_auth.h      - definitions for ONC RPC authentication
 111 rpc_msg.h       - definitions for ONC RPC messages
 112 send-ack.awk    - unidirectional tcp send/ack awk script
 113 slcompress.h    - SLIP/PPP Van Jacobson compression (RFC1144) definitions
 114 smb.h           - SMB/CIFS definitions
 115 smbutil.c       - SMB/CIFS utility routines
 116 stime.awk       - TCP send awk script
 117 tcp.h           - TCP definitions
 118 tcpdump.1       - manual entry
 119 tcpdump.c       - main program
 120 timeval-operations.h - timeval operations macros
 121 udp.h           - UDP definitions
 122 util-print.c    - utility routines for protocol printers
 123 win32           - headers and routines for building on Win32 systems