Skip to content

Commit d9dc66f

Browse files
committed
man: Explain "any" device better in pcap_open_live(3PCAP). [skip ci]
Capture some of the comments Guy Harris made in GH issue #1055. Do not specify 2.2 as the the minimum Linux version because libpcap already requires at least 2.6.27.
1 parent 19f7b2e commit d9dc66f

File tree

2 files changed

+8
-4
lines changed

2 files changed

+8
-4
lines changed

CHANGES

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ DayOfTheWeek, Month DD, YYYY / The Tcpdump Group
3131
another incorporate-remote-capture project. (issue #1120)
3232
Documentation:
3333
Document a standard format for writing out BPF filter programs.
34+
Explain "any" device better in pcap_open_live(3PCAP).
3435
Building and testing:
3536
Apply GNU Hurd support patch from the Debian package.
3637
CI: Introduce and use LIBPCAP_CMAKE_TAINTED.

pcap_open_live.3pcap

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
1818
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
1919
.\"
20-
.TH PCAP_OPEN_LIVE 3PCAP "6 December 2017"
20+
.TH PCAP_OPEN_LIVE 3PCAP "5 December 2023"
2121
.SH NAME
2222
pcap_open_live \- open a device for capturing
2323
.SH SYNOPSIS
@@ -41,12 +41,15 @@ pcap_t *pcap_open_live(const char *device, int snaplen,
4141
is used to obtain a packet capture handle to look
4242
at packets on the network.
4343
.I device
44-
is a string that specifies the network device to open; on Linux systems
45-
with 2.2 or later kernels, a
44+
is a string that specifies the network device to open; on all supported Linux
45+
systems, as well as on recent versions of macOS and Solaris, a
4646
.I device
4747
argument of "any" or
4848
.B NULL
49-
can be used to capture packets from all interfaces.
49+
can be used to capture packets from all network interfaces. The latter should
50+
not be confused with all available capture devices as seen by
51+
.BR pcap_findalldevs (3PCAP),
52+
which may also include D-Bus, USB etc.
5053
.PP
5154
.I snaplen
5255
specifies the snapshot length to be set on the handle.

0 commit comments

Comments
 (0)