Commit Graph

122 Commits

Author SHA1 Message Date
Josh Soref
38050da48e Fix spelling
* account
* address
* adjacency
* alignment
* anymore
* ascii
* assumption
* blithely
* canonical
* compound
* consecutive
* control
* diagnostics
* disassociation
* fairly
* fallthrough
* greatest
* identification
* multihop
* multiplexed
* nonexistent
* notifiable
* notwithstanding
* number
* polynomial
* preexisting
* proprietary
* quenches
* reassociation
* redefinition
* refresh
* solicitation
* specifying
* support
* the
* unacceptable

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
2023-08-20 07:19:40 +00:00
Jesse Rosenstock
97fd59b025
tcpdump.1.in: Delete Linux 2.0 references
Delete Linux 2.0 bugs from bug list.

Linux 2.0.x releases are from 1996-2004. The man page recommended upgrading to Linux 2.2, released in 1999.

https://en.wikipedia.org/wiki/Linux_kernel_version_history#Releases_up_to_2.6.0

I'm assuming these >20 year old bug references aren't that useful now.
2023-05-07 17:21:23 +02:00
Denis Ovsienko
658778cc02 man: Format "output format" subsections properly. [skip ci] 2023-03-18 16:24:26 +00:00
Denis Ovsienko
eb2f8839ac man: Spell TCP header flags names. [skip ci]
In the prose use the names from respective registry [1], which says:

* "PSH", not "PUSH",
* "CWR", not "ECN CWR", and
* "ECE", not "ECN-Echo".

This does not resolve all known inconsistencies related to TCP flags,
but at least makes the problem smaller.

1: https://www.iana.org/assignments/tcp-parameters/tcp-parameters.xhtml
2023-03-12 20:25:22 +00:00
Francois-Xavier Le Bail
ded255a178 man: Add the TCP flag names tcp-ece and tcp-cwr
State that these flag names became available when linking with libpcap
1.9.0 or later.
2023-02-26 15:16:11 +01:00
Denis Ovsienko
7047194eaf man: Lose an excess newline in tcpdump(1).
This improves the derived HTML version and has no effect on the plain
text version, as far as I can tell.

[skip ci]
2022-10-19 21:40:50 +01:00
Denis Ovsienko
de27d59e78 man: Update tcpdump(1) about "-i any". [skip ci]
Call it consistently a "pseudo-interface" and mention other OSes that
seem to support it, as far as reports on the interwebs go.
2022-07-30 15:46:44 +01:00
Francois-Xavier Le Bail
7d2bc7fcb5 Fix some typos
[skip ci]
2022-07-04 14:03:15 +02:00
Denis Ovsienko
af98bb4776 Convert CONTRIBUTING to Markdown. [skip ci] 2022-06-09 10:16:26 +01:00
Denis Ovsienko
d65f3f14d4 man: Put commit 4a904f4 right. [skip ci] 2022-02-13 10:39:46 +00:00
Denis Ovsienko
4a904f4362 man: Refer to pcap-filter(7) early. [skip ci] 2022-01-20 15:23:09 +00:00
Nathan O'Sullivan
63b104dc5b Add --print-sampling option to print every Nth packet
New option `--print-sampling=NTH` will parse and print every NTH packet,
with all other packets producing no output. This option enables
`--print` and `-S` flags.

Print sampling is useful for real-time inspection of an interface with
a high packet rate, or initial inspection of large capture files.
2022-01-17 19:43:59 +00:00
Denis Ovsienko
cf1b9455e7 Reword the current maintainer in README.md. [skip ci]
Use the correct tense and subject (see tcpdump-htdocs commit feaf9ff).
2021-12-25 23:31:37 +00:00
Denis Ovsienko
b99f16cd33 man: Punctuate "RFC" properly. [skip ci]
As far as I know, the nominal format is "RFC n", not "RFC-n" or "RFCn".
2021-12-06 19:15:40 +00:00
Francois-Xavier Le Bail
69c0a4b0cc man: Update the date 2021-11-29 13:59:51 +01:00
Francois-Xavier Le Bail
b27c4e43a2 man: Update the print interface for the packet count to stdout
This is a follow-up to commit a0e19c0cae.
2021-11-29 12:13:54 +01:00
Francois-Xavier Le Bail
17cd0305d4 Document "-T quic" 2021-11-09 10:15:23 +01:00
Denis Ovsienko
42ae99dd6c man: Fixup some formatting. [skip ci]
Use BSD style references and protect some refs from hyphenation.
2021-10-20 13:47:59 +01:00
Denis Ovsienko
95483a4c7b Update the man page timestamp. [skip ci] 2021-07-18 23:56:46 +01:00
Guy Harris
5ff873f0d2 Improve the handling of size suffixes for -C.
Support upper-case suffixes (K/M/G) as well as lower-case suffixes.

Make sure nothing *follows* the suffix.

We don't need to check for the suffix before parsing the number; the
parsing routines stop if they see a non-digit character.
2021-07-10 14:01:18 -07:00
Steve Kay
81e2588d2b optional unit suffix on -C 2021-05-08 14:32:24 -04:00
Francois-Xavier Le Bail
eac90e30d2 man: Update DNS sections
The DNS transactions also take place over TCP.

Harmonize text: s/not including/excluding/ like in Name Server Responses
section.

[skip ci]
2021-04-25 20:35:18 +02:00
Denis Ovsienko
76e6b9c658 man: Update a reference as www.cifs.org is gone. [skip ci] 2021-01-28 23:29:57 +00:00
Denis Ovsienko
1462b6133b man: Note the -x/-X quirk for truncated packets [skip ci]
Accurate skipping of the link level header was working before the
conversion started, it will hopefully work after the conversion is
complete, but meanwhile be clear about what it is now.
2020-12-21 02:46:37 +00:00
Denis Ovsienko
a039d03bc2 man: Make more editorial improvements.
Improve some punctuation, spell some acronyms in upper case, fix a term.
2020-10-17 17:55:37 +01:00
Denis Ovsienko
afb355923c Add more "-v" detail to tcpdump(1) for GH #380. [skip ci]
Capture what Guy has figured out so far.
2020-09-15 12:15:47 +01:00
Denis Ovsienko
870eeabe89 Report periodic stats only when safe to do so. [skip ci]
As explained in GH #155, when tcpdump is given -r, -w and -v and it
takes long enough to read from the input file (because it is stdin
connected through network or a pipe to stdout of another tcpdump doing
a live capture), pcap_loop() will error before long. One of the ways to
reproduce the fault is as follows:

$ tcpdump -i eno1 -w - | tcpdump -r - -w /tmp/tmp.pcap -v
tcpdump: listening on eno1, link-type EN10MB (Ethernet), snapshot length 262144 bytes
reading from file -, link-type EN10MB (Ethernet), snapshot length 262144
tcpdump: pcap_loop: error reading dump file: Interrupted system call

Skip the verbose_stats_dump() timer setup in this specific corner case
for the time being and document it.
2020-08-29 02:48:07 +01:00
Denis Ovsienko
d5bb7824e1 Fixup some letter case in the man page. [skip ci] 2020-08-22 01:52:02 +01:00
Denis Ovsienko
9d69766c33 Update the man page for "-d", "-i" and "-y".
Describe the changes in behaviour after commit 74e6075, which implements
the discussion made in GH #804.

[skip ci]
2020-08-10 12:04:51 +01:00
Denis Ovsienko
f72070a7e0 Use more BSD style references in the man page.
[skip ci]
2020-07-28 16:10:59 +01:00
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