mirrors/tcpdump
0
0
Fork 0
mirror of https://github.com/the-tcpdump-group/tcpdump.git synced 2024-11-23 18:14:29 +08:00
Code Issues Packages Projects Releases Wiki Activity
b779eda489
tcpdump/INSTALL.md

143 lines
6.1 KiB
Markdown
Raw Normal View History

Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
# tcpdump installation notes
Many UN*Xes come with libpcap, so you might not have to install tcpdump.org's libpcap in order to build tcpdump.org's tcpdump (the configure script doesn't assume the latest version of libpcap, so it should be possible to build tcpdump with older versions of libpcap). By default, tcpdump is installed with universal execute permissions, and no special privileges; that way, anybody can use it to read a capture. Remove the comments about capture permissions, as it applies only to systems using BPF. The tcpdump man page gives the gory details of capture permissions; refer users there. Remove the comment about libpcap; it's in the libpcap INSTALL.txt, where it belongs.
2007-06-16 04:12:32 +08:00
If you have not built libpcap, and your system does not have libpcap
installed, install libpcap first. Your system might provide a version
of libpcap that can be installed; if so, to compile tcpdump you might
need to install a "developer" version of libpcap as well as the
Fix minor issues in INSTALL.md. [skip ci]
2023-03-05 07:06:13 +08:00
"run-time" version. You can also install The Tcpdump Group version of
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
libpcap; see [this file](README.md) for the location.
Initial revision
1999-10-08 07:47:09 +08:00
Refine INSTALL.txt. [skip ci] Say C99 instead of ANSI C and explain multiple versions better.
2021-11-19 22:33:22 +08:00
You will need a C99 compiler to build tcpdump. The build system
will abort if your compiler is not C99 compliant. If this happens, use
the generally available GNU C compiler (GCC) or Clang.
Initial revision
1999-10-08 07:47:09 +08:00
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
After libpcap has been built (either install it with `make install` or
update: - gcc pointer - configure and make install instructions - some versions - list of files
2000-07-29 14:50:51 +08:00
make sure both the libpcap and tcpdump source trees are in the same
autoconf: Add autogen.sh, remove configure and config.h.in Put autoconf-generated files in the release tarball. The minimum required version of autoconf is currently 2.69. If version 2.69 or later is already installed and there is no autoconf default, it may be necessary to set the AUTORECONF environment variable to enable the one to use, like: AUTORECONF=autoreconf-2.69 ./autogen.sh or AUTORECONF=autoreconf-2.71 ./autogen.sh
2023-01-31 18:11:12 +08:00
directory), do the following steps:
* If you build from a git clone rather than from a release archive,
run `./autogen.sh` (a shell script). The autogen.sh script will
build the `configure` and `config.h.in` files.
On some system, you may need to set the `AUTORECONF` variable, like:
`AUTORECONF=autoreconf-2.69 ./autogen.sh`
to select the `autoreconf` version you want to use.
* Run `./configure` (a shell script). The configure script will
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
determine your system attributes and generate an appropriate `Makefile`
autoconf: Add autogen.sh, remove configure and config.h.in Put autoconf-generated files in the release tarball. The minimum required version of autoconf is currently 2.69. If version 2.69 or later is already installed and there is no autoconf default, it may be necessary to set the AUTORECONF environment variable to enable the one to use, like: AUTORECONF=autoreconf-2.69 ./autogen.sh or AUTORECONF=autoreconf-2.71 ./autogen.sh
2023-01-31 18:11:12 +08:00
from `Makefile.in`. The configure script has a number of options to
control the configuration of tcpdump; `./configure --help` will show
them.
* Next, build tcpdump by running `make`.
On OpenBSD, you may need to set, before the `make`, the `AUTOCONF_VERSION`
variable like:
`AUTOCONF_VERSION=2.69 make`
Initial revision
1999-10-08 07:47:09 +08:00
Fix minor issues in INSTALL.md. [skip ci]
2023-03-05 07:06:13 +08:00
If everything builds fine, `su` and type `make install`. This will install
Many UN*Xes come with libpcap, so you might not have to install tcpdump.org's libpcap in order to build tcpdump.org's tcpdump (the configure script doesn't assume the latest version of libpcap, so it should be possible to build tcpdump with older versions of libpcap). By default, tcpdump is installed with universal execute permissions, and no special privileges; that way, anybody can use it to read a capture. Remove the comments about capture permissions, as it applies only to systems using BPF. The tcpdump man page gives the gory details of capture permissions; refer users there. Remove the comment about libpcap; it's in the libpcap INSTALL.txt, where it belongs.
2007-06-16 04:12:32 +08:00
tcpdump and the manual entry. Any user will be able to use tcpdump to
read saved captures. Whether a user will be able to capture traffic
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
depends on the OS and the configuration of the system; see the
[tcpdump man page](https://www.tcpdump.org/manpages/tcpdump.1.html)
Get Markdown right in the previous change. [skip ci] HTML 3 had problems, but confusing italic for bold was not one of them.
2023-03-05 07:21:31 +08:00
for details. Do **NOT** give untrusted users the ability to
Many UN*Xes come with libpcap, so you might not have to install tcpdump.org's libpcap in order to build tcpdump.org's tcpdump (the configure script doesn't assume the latest version of libpcap, so it should be possible to build tcpdump with older versions of libpcap). By default, tcpdump is installed with universal execute permissions, and no special privileges; that way, anybody can use it to read a capture. Remove the comments about capture permissions, as it applies only to systems using BPF. The tcpdump man page gives the gory details of capture permissions; refer users there. Remove the comment about libpcap; it's in the libpcap INSTALL.txt, where it belongs.
2007-06-16 04:12:32 +08:00
capture traffic. If a user can capture traffic, he or she could use
utilities such as tcpdump to capture any traffic on your net, including
passwords.
Initial revision
1999-10-08 07:47:09 +08:00
update: - gcc pointer - configure and make install instructions - some versions - list of files
2000-07-29 14:50:51 +08:00
Note that most systems ship tcpdump, but usually an older version.
Refine INSTALL.txt. [skip ci] Say C99 instead of ANSI C and explain multiple versions better.
2021-11-19 22:33:22 +08:00
Building tcpdump from source as explained above will usually install the
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
binary as `/usr/local/bin/tcpdump`. If your system has other tcpdump
Fix minor issues in INSTALL.md. [skip ci]
2023-03-05 07:06:13 +08:00
binaries, you might need to deinstall these or to set the `PATH` environment
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
variable if you need the `tcpdump` command to run the new binary
(`tcpdump --version` can be used to tell different versions apart).
Initial revision
1999-10-08 07:47:09 +08:00
Fix minor issues in INSTALL.md. [skip ci]
2023-03-05 07:06:13 +08:00
If your system is not one that we have tested tcpdump on, you may have
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
to modify the `configure` script and `Makefile.in`. Please
[send us patches](https://www.tcpdump.org/index.html#patches)
Update the list of files, and remove the text about not sending in an ASCII dumper. The list of files needs more descriptions, and the text in general probably needs another once-over.
2000-01-25 08:47:09 +08:00
for any modifications you need to make.
Initial revision
1999-10-08 07:47:09 +08:00
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
Please see [this file](README.md) for notes about tested platforms.
added list of supported platforms
2000-01-15 02:05:45 +08:00
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
## Description of files
```
Add some missing entries, and use tabs on some entries that weren't using them.
2003-12-15 10:38:32 +08:00
CHANGES - description of differences between releases
Convert CONTRIBUTING to Markdown. [skip ci]
2022-06-09 17:14:26 +08:00
CONTRIBUTING.md - guidelines for contributing
update: - gcc pointer - configure and make install instructions - some versions - list of files
2000-07-29 14:50:51 +08:00
CREDITS - people that have helped tcpdump along
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
INSTALL.md - this file
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
LICENSE - the license under which tcpdump is distributed
Initial revision
1999-10-08 07:47:09 +08:00
Makefile.in - compilation rules (input to the configure script)
Refine README.md and some related files. [skip ci] Lose the README symlink, it was a bad idea of mine to add it in the first place as it made the packaging problem space bigger, not smaller. Remove two CI badges at the top of README.md. One badge was stale anyway, and the other does not represent the current CI configuration, which is bigger, changes frequently and fits the web-site much better. Remove the reference to ITA, it has been down for quite a while, it looks like it won't re-emerge this time. Merge PLATFORMS into README.md.
2021-04-17 01:25:11 +08:00
README.md - description of distribution
Initial revision
1999-10-08 07:47:09 +08:00
VERSION - version of this release
aclocal.m4 - autoconf macros
addrtoname.c - address to hostname routines
addrtoname.h - address to hostname definitions
Update the list of files in INSTALL.txt. [skip ci]
2018-07-29 05:03:57 +08:00
addrtostr.c - address to printable string routines
addrtostr.h - address to printable string definitions
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
ah.h - IPSEC Authentication Header definitions
Initial revision
1999-10-08 07:47:09 +08:00
appletalk.h - AppleTalk definitions
Do case-insensitive comparisons assuming ASCII strings. Do the case-insensitive comparisons in a locale-independent fashion that only maps ASCII letters, in the standard English-language fashion; that way, we don't get bitten by, for example, Turkish having separate "i with dot" and "i without dot" letters, with lower-case "i with dot" being mapped to upper-case "I with dot" rather than being mapped to "I".
2015-06-12 06:47:44 +08:00
ascii_strcasecmp.c - locale-independent case-independent string comparison
routines
Initial revision
1999-10-08 07:47:09 +08:00
atime.awk - TCP ack awk script
Add items for SunATM.
2002-07-16 12:46:41 +08:00
atm.h - ATM traffic type definitions
autoconf: Add autogen.sh, remove configure and config.h.in Put autoconf-generated files in the release tarball. The minimum required version of autoconf is currently 2.69. If version 2.69 or later is already installed and there is no autoconf default, it may be necessary to set the AUTORECONF environment variable to enable the one to use, like: AUTORECONF=autoreconf-2.69 ./autogen.sh or AUTORECONF=autoreconf-2.71 ./autogen.sh
2023-01-31 18:11:12 +08:00
autogen.sh - build configure and config.h.in (run this first)
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
bpf_dump.c - BPF program printing routines, in case libpcap doesn't
INSTALL.md: Add information about bpf_dump.c OpenBSD libpcap does not implement bpf_dump(). That's why we need to keep the code and the checks in CMakeLists.txt and configure.ac even if the official libpcap implement bpf_dump() since version 0.6. See the test in PR #1094.
2023-10-29 02:28:27 +08:00
have them. A known example is OpenBSD libpcap.
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
chdlc.h - Cisco HDLC definitions
Add in missing files.
2004-10-12 05:27:43 +08:00
cpack.c - functions to extract packed data
cpack.h - declarations of functions to extract packed data
Initial revision
1999-10-08 07:47:09 +08:00
config.guess - autoconf support
config.sub - autoconf support
Rename configure.in to configure.ac. This matches what was done with libpcap; it's what autoconf prefers.
2017-12-01 02:20:37 +08:00
configure.ac - configure script source
INSTALL.md: Add doc/README.* [skip ci]
2022-07-18 20:06:59 +08:00
doc/README.* - some building documentation
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
ethertype.h - Ethernet type value definitions
Initial revision
1999-10-08 07:47:09 +08:00
extract.h - alignment definitions
Move the definitions of the various GMPLS "struct tok"s out of gmpls.h into a new gmpls.c file; have gmpls.h contain only external declarations of those structures. That removes compiler warnings about static structures being defined but not used, and also lets more than one file share structures used in both of those files, rather than having private definitions of them.
2003-06-10 07:28:08 +08:00
gmpls.c - GMPLS definitions
gmpls.h - GMPLS declarations
gre: move the header flags to a gre.h header. That allows dissectors such as the ERSPAN dissector to check individual flags without having their own definitions of the flags.
2023-10-20 14:04:26 +08:00
gre.h - GRE definitions
Initial revision
1999-10-08 07:47:09 +08:00
install-sh - BSD style install script
interface.h - globals, prototypes and definitions
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
ip.h - IP definitions
ip6.h - IPv6 definitions
Add in missing files.
2004-10-12 05:27:43 +08:00
ipproto.c - IP protocol type value-to-name table
Add a new "ipproto.h" header file, with definitions of IP protocol type values. Use that rather than private definitions in various files. Add "gmpls.h" to the list of files in FILES, and add it and "ipfc.h" to the list of files in INSTALL.
2003-06-07 19:57:51 +08:00
ipproto.h - IP protocol type value definitions
Add in missing files.
2004-10-12 05:27:43 +08:00
l2vpn.c - L2VPN encapsulation value-to-name table
l2vpn.h - L2VPN encapsulation definitions
State there are currently no OS dependent defines and prototypes The last header was removed by commit 6008cb83b72a8fafe9c69f6955f4bdffbc049a09.
2023-02-24 16:45:27 +08:00
lbl/os-*.h - OS-dependent defines and prototypes (currently none)
Initial revision
1999-10-08 07:47:09 +08:00
llc.h - LLC definitions
makemib - mib to header script
mib.h - mib definitions
Update the list of files, and remove the text about not sending in an ASCII dumper. The list of files needs more descriptions, and the text in general probably needs another once-over.
2000-01-25 08:47:09 +08:00
missing/* - replacements for missing library functions
Extract NTP printing This method is required to dissect some RADIUS attributes
2018-10-04 02:19:37 +08:00
ntp.c - functions to handle ntp structs
ntp.h - declarations of functions to handle ntp structs
Initial revision
1999-10-08 07:47:09 +08:00
mkdep - construct Makefile dependency list
Add in missing files.
2004-10-12 05:27:43 +08:00
mpls.h - MPLS definitions
update: - gcc pointer - configure and make install instructions - some versions - list of files
2000-07-29 14:50:51 +08:00
nameser.h - DNS definitions
Add in missing files.
2004-10-12 05:27:43 +08:00
netdissect.h - definitions and declarations for tcpdump-as-library
(under development)
Update the list of files, and remove the text about not sending in an ASCII dumper. The list of files needs more descriptions, and the text in general probably needs another once-over.
2000-01-25 08:47:09 +08:00
nfs.h - Network File System V2 definitions
Initial revision
1999-10-08 07:47:09 +08:00
nfsfh.h - Network File System file handle definitions
Add in missing files.
2004-10-12 05:27:43 +08:00
nlpid.c - OSI NLPID value-to-name table
nlpid.h - OSI NLPID definitions
Initial revision
1999-10-08 07:47:09 +08:00
ospf.h - Open Shortest Path First definitions
packetdat.awk - TCP chunk summary awk script
parsenfsfh.c - Network File System file parser routines
NetBSD support for multiple data link types on an interface, from David Young <dyoung@ojctech.com>, with some minor changes by Jason R. Thorpe <thorpej@netbsd.org>, and further changes by me to: use "-y" rather than "-D" to set the link type ("-D" was already taken); use libpcap APIs to map between data link type names and values; supply stub versions of missing-but-needed libpcap APIs. Update Jason Thorpe's e-mail address (Zembu is going away, if it hasn't done so already).
2002-12-19 17:27:54 +08:00
pcap-missing.h - declarations of functions possibly missing from libpcap
Initial revision
1999-10-08 07:47:09 +08:00
ppp.h - Point to Point Protocol definitions
Update to reflect some recent changes. It probably needs more updates for new protocols.
2016-08-10 02:56:03 +08:00
print.c - Top-level routines for protocol printing
Move the printer summaries from INSTALL.txt to each printer with the tag '\summary:' for greping. Remark: Currently some printers have no summary line. Moreover: Summarize all printers with a single line in INSTALL.txt
2016-08-14 21:42:19 +08:00
print-*.c - The netdissect printers
Have our own headers to declare the format of ONC (Sun) RPC messages on the wire; the definitions in many systems use u_long, which is 64 bits long on many platforms - that's OK for in-memory structures, but it doesn't match what's on the wire. Use headers based on the Sun ones, but use u_int32_t for fields, and otherwise make the structures match what's on the wire, and change some names to avoid collision with <rpc/rpc.h>, which print-sunrpc.c includes to declare "getrpcbynumber()" and the structure it returns. Record whether "getrpcbynumber()" is found, and use it only if it's found, rather than basing the decisison on whether we're building for Win32 or not.
2004-12-27 08:41:29 +08:00
rpc_auth.h - definitions for ONC RPC authentication
rpc_msg.h - definitions for ONC RPC messages
Initial revision
1999-10-08 07:47:09 +08:00
send-ack.awk - unidirectional tcp send/ack awk script
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
slcompress.h - SLIP/PPP Van Jacobson compression (RFC1144) definitions
smb.h - SMB/CIFS definitions
smbutil.c - SMB/CIFS utility routines
Initial revision
1999-10-08 07:47:09 +08:00
stime.awk - TCP send awk script
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
tcp.h - TCP definitions
Initial revision
1999-10-08 07:47:09 +08:00
tcpdump.1 - manual entry
tcpdump.c - main program
Fix display of timestamps with -ttt and -ttttt options - Fix display of some nanoseconds timestamps For example, bad print 00:-16:-2.000851566 is now 00:00:00.037851566 - Fix display of timestamp of a packet when it is lower than previous one For example, bad print 00:00:-1.000999790 is now -00:00:00.000000210
2015-07-03 01:14:49 +08:00
timeval-operations.h - timeval operations macros
Update and fix up the list of files and the note on Linux.
2002-07-16 12:36:08 +08:00
udp.h - UDP definitions
Update to reflect some recent changes. It probably needs more updates for new protocols.
2016-08-10 02:56:03 +08:00
util-print.c - utility routines for protocol printers
Reformat the installation notes in Markdown. [skip ci]
2021-12-22 22:02:13 +08:00
```
Reference in New Issue Copy Permalink