Commit Graph

92 Commits

Author SHA1 Message Date
Francois-Xavier Le Bail
8a33158e88 man: Add an example for printing TCP with RST+ACK both set
Partially based on a Guy's comment in issue #860.

[skip ci]
2020-06-25 09:52:55 +02:00
Guy Harris
f025901fd2 -i affects more than just capture.
Expand the description of the -i flag.
2020-05-06 16:36:59 -07:00
Francois-Xavier Le Bail
9736efeb96 Add "domain" as an option for -T
This allows tcpdump to handle DNS running on non-standard ports.

Add two test files with DNS over TCP and DNS over UDP, port 8053.
2020-03-02 20:53:23 +01:00
Francois-Xavier Le Bail
fc84133d47 Document "-T ptp" and "-T someip".
Moreover:
Sort by type.

[skip ci]
2020-03-02 15:16:07 +01:00
Francois-Xavier Le Bail
3520ce0057 man: Add the long-options --micro and --nano in the SYNOPSIS section
Moreover:
Update the date.

[skip ci]
2020-02-28 12:08:23 +01:00
Francois-Xavier Le Bail
dbe598a05d Update the date in tcpdump.1.in
[skip ci]
2020-02-27 15:58:56 +01:00
Francois-Xavier Le Bail
4d810e062d Print an optional packet count on stderr instead of printing packets
This change add an option to print only on stderr the packet count
when reading capture file(s) instead of parsing/printing the packets.

If a filter is specified on the command line, tcpdump counts only
packets that were matched by the filter expression.

The option name is '--count'.
2020-02-26 20:12:30 +01:00
Guy Harris
12cf799245 -W has an argument.
Should fix GitHub issue the-tcpdump-group/tcpdump-htdocs/#15.
2020-02-22 01:58:16 -08:00
Nan Xiao
3d257628df
Fix typo in tcpdump.1.in 2020-02-17 21:41:16 +08:00
Francois-Xavier Le Bail
c2212b3229 man page: Update the protocol name 2020-02-06 20:14:14 +01:00
Denis Ovsienko
03c32ba792 Fixup a roff warning in tcpdump.1.in
<standard input>:1918: warning [p 19, 1.7i]: cannot adjust line

See libpcap commit bf5d5eb.

[skip ci]
2019-09-15 16:22:26 +01:00
Francois-Xavier Le Bail
8534f3b7bf Use more HTTPS in URLs
[skip ci]
2019-08-19 15:49:21 +02:00
Denis Ovsienko
dcf83034e0 Update the date in tcpdump.1.in.
[skip ci]
2019-04-11 20:35:52 +01:00
Ricardo Nabinger Sanchez
371e1fca31 Add shortcuts for setting time stamp precision
Add two shortcuts (as long-options) for setting the time stamp
precision: --micro and --nano.  While adding these options, reshuffle
the usage message to group up the options related to time stamp, and
removing the macro TIME_STAMP_PRECISION_USAGE.

If setting the time stamp precision is not supported by the available
libpcap, the usage won't mention these options (including
--time-stamp-precision), but they will still be presented in the
manpage.
2019-04-03 08:34:41 -03:00
Andrea Ieri
362304dd68 Amend the documentation about the use of the -C -G and -W switches.
When using all three switches (-C -G and -W), the behavior is
practically identical to only using -C and -G, as the -W flag will only
affect the filename suffix.

Fixes #695
2018-12-19 10:17:31 +01:00
Francois-Xavier Le Bail
51eefc7c84 man page: Update the -ttt and -ttttt options sections
The delta is printed with microsecond or nanosecond resolution depending
on the --time-stamp-precision option (default is microsecond resolution).
2018-10-05 15:49:14 +02:00
Denis Ovsienko
3e3bb970a8 Do not decrease font size for CLI output examples.
Three CLI output examples in the tcpdump man page used to request a
smaller font size since the beginning of the version control history.
That had no effect on the plain text format, and made the examples
difficult to read in the HTML format, so get rid of it.

[skip ci]
2018-07-19 11:18:57 +00:00
Denis Ovsienko
eb962af8e8 Fixup some references in the man page.
This way the references are proper hyperlinks in the HTML version.

[skip ci]
2018-07-18 12:04:43 +00:00
Denis Ovsienko
bdadd9521d Fixup some hyphenation in the man page.
[skip ci]
2018-07-11 10:29:35 +01:00
Denis Ovsienko
39704bbb49 Update the timestamp in the man page.
[skip ci]
2018-07-10 08:39:14 +01:00
Denis Ovsienko
57cb8fa2c8 Use HTTPS in the www.tcpdump.org URLs.
[skip ci]
2018-07-09 11:05:18 +01:00
Eric S. Raymond
2edef3459f Fix a broken font escape in the manual page. 2018-04-15 13:40:25 -04:00
Guy Lewin
0e79762874 Separate flushing the packet buffer from SIGINFO to SIGUSR2 2018-04-08 01:46:53 +03:00
Guy Harris
3bc62cd35f Use pcapng as the name of the file format.
At one point, I remember a discussion resulting in the official name of
the next-generation replacement for pcap format being changed to
"pcapng", with no hyphen.

Make tcpdump reflect that.

While we're at it, uppdate to use "macOS" as the name of Apple's
UNIX-for-Macs, as appropriate (don't use it for versions that were still
called Mac OS X or OS X).
2018-01-08 18:50:06 -08:00
Guy Harris
a5874ee6b1 Update the -s documentation.
The -s default is now large, so it's not as if you'll have to increase
it to get more packet data; you might have to *decrease* it to avoid
dropping packets.
2017-12-14 15:48:30 -08:00
Denis Ovsienko
a0bcaa3081 It is once per second, not every 10 seconds.
[skip ci]
2017-10-13 10:42:11 +01:00
Denis Ovsienko
2195ab7c15 Update the SSL library credits in the man page. 2017-10-13 10:35:58 +01:00
Denis Ovsienko
6bb6afbc12 Add a missing closing quote to the man page. 2017-10-12 14:55:06 +01:00
Guy Harris
9b845d6549 Add --print, to cause packet printing even with -w.
While we're at it, clean up some man page issues found in the process of
updating the man page to describe --print.

Fixes GitHub issue #639.
2017-10-11 12:09:42 -07:00
Mitsunori Komatsu
4def3a4c8d Fix typo "tcp-act" in manpage 2017-09-19 15:41:42 +01:00
Guy Harris
e48f4ca6ca Clean up the output format description somewhat.
Put the information about the time stamp first, and put in a more
detailed description of IPv4 header information before TCP header
information is described.

Update the description of TCP header informaton to reflect current
reality.

More updating is probably needed.
2017-05-23 13:39:57 -07:00
Guy Harris
5f718c2742 tcpdump can be of use for people who known nothing of TCP, these days.
The "tcp" in "tcpdump" is historical; these days, it's a general-purpose
network analyzer.  Don't claim tcpdump will not be of much use to you if
you don't know TCP.
2017-05-23 00:57:19 -07:00
Denis Ovsienko
5512e02f3a Prevent hyphenation for the e-mail address.
It did not look right in the text version of the man page.
2017-02-04 18:09:41 +00:00
Denis Ovsienko
be1e19f50c refine the feedback guidelines
Provide better detailed guidelines in CONTRIBUTING and update a number
of other files to refer to that file so that the directions are now
more uniform.
2017-02-02 11:38:05 +00:00
Guy Harris
d4876278a7 Note that interfaces may have numerical names.
If N is a number, and is the name of an interface on the system, "-i N"
will now attempt to open that interface, not the Nth interface in the
list of interfaces.  See GitHub issue #522.
2016-08-09 11:40:02 -07:00
Andrew Darqui
fc213645d4 Initial support for the REdis Serialization Protocol known as RESP.
This commit adds support for RESP as defined in: http://redis.io/topics/protocol.
It also supports inline commands and pipelining. Due to the popularity of RESP,
numerous services are emerging that use this protocol. You may decode RESP packets
on arbitrary ports using the "-T resp" option.

Example captures can be found in tests/resp_*.

A simple way to test this parser is to start redis-server and then run
redis-cli commands such as "redis-cli set key value".

Traditionally, redis-cli monitor is used to debug redis. Unfortunately,
the "monitor" command can cause significant load on a redis-server in
production. This parser may be used as a non-invasive alternative to
redis-cli monitor.
2016-04-26 11:00:21 +02:00
Denis Ovsienko
918517e1dd update last modified date in man page(s) 2015-12-17 23:53:36 +00:00
Francois-Xavier Le Bail
d128eefdb3 Fix the maximum snaplen value in the man page 2015-09-17 11:24:07 +02:00
Francois-Xavier Le Bail
bf657452ef Remove no longer used option 'R' 2015-09-08 09:14:13 +02:00
Guy Harris
6b6b9f5a79 Give more details about packet time stamps.
Don't speak of "Ethernet" and "wire", as you might not be sniffing an
Ethernet or, indeed, any form of wired network.

Note that not only could there be a delay between the point at which the
interface is finished receiving the packet and when an interrupt is
delivered (whether due to bus delays, polling rather than immediate
interrupts being used, or delays in the CPU responding to the interrupt,
or more than one of those) but also a delay between the point at which
the kernel responds to the interrupt and the point at which it actually
applies a time stamp to the packet.
2015-07-29 09:17:30 -07:00
Wolfgang Karall
58c31137af document SIGUSR1 in manual page 2015-02-24 12:36:51 +01:00
Guy Harris
d71793791f Use immediate mode if available.
If libpcap has pcap_set_immediate_mode(), then default to immediate mode
if we're printing packets to a terminal, and use immediate mode if
--immediate-mode is specified.
2015-02-10 14:55:43 -08:00
Guy Harris
378657cec5 Give more details about the printed time stamps. 2014-11-05 09:16:45 -08:00
Francois-Xavier Le Bail
084185e1f2 update tcpdump.1.in for missing line 2014-07-11 11:03:57 +02:00
Francois-Xavier Le Bail
8ad1badda4 update tcpdump.1.in for good aligment in tcpdump.1.txt 2014-07-11 10:45:05 +02:00
Francois-Xavier Le Bail
f22c9ec50c add a short option '#', same as long option '--number' (print a packet number) 2014-07-10 14:47:11 +02:00
Guy Harris
e76768c97a Give more details for --time-stamp-precision. 2014-06-25 11:45:29 -07:00
Michal Sekletar
52b27d11fc Introduce --time-stamp-precision
A while ago we introduced new API in libpcap which made possible to
request time stamps with higher precision (nanoseconds). This commit
aims to move things forward and implement missing bits. It introduces
new long option --time-stamp-precision. Note that there is no equivalent
short option.

When used for a live capture tcpdump will ask the kernel for time stamp
with desired precision and tcpdump will print fraction part of the time
stamp using respective format. We currently support only microsecond and
nanosecond precision. In the future we might support even more granular
time stamp precision, but we should be fine to support only
microseconds and nanoseconds for now. libpcap doesn't provide anything
else at the moment anyway.

When used in combination with -r/-w options then we obtain time stamps
appropriately scaled up or down from libpcap. Also note that distinct
magic number is used for savefiles containing nanosecond time stamps.
2014-05-14 14:18:40 +02:00
Francois-Xavier Le Bail
3d553602b1 date update 2014-05-07 17:37:23 +02:00
Guy Harris
7c4458b1b6 Document --version. 2014-05-06 14:29:35 -07:00