Man page of PCAP_STATS
Section: Misc. Reference Manual Pages (3PCAP)
Updated: 25 July 2018
Return to Main Contents
This man page documents libpcap version 1.9.1.
Your system may have a different version installed, possibly with some
local modifications. To achieve the best results, please make sure this
version of this man page suits your needs. If necessary, try to look for
a different version on this web site or in the man pages available in your
pcap_stats - get capture statistics
int pcap_stats(pcap_t *p, struct pcap_stat *ps);
fills in the
pointed to by its second argument. The values represent
packet statistics from the start of the run to the time of the call.
is supported only on live captures, not on ``savefiles''; no statistics
are stored in ``savefiles'', so no statistics are available when reading
from a ``savefile''.
has the following members:
number of packets received;
number of packets dropped because there was no room in the operating
system's buffer when they arrived, because packets weren't being read
number of packets dropped by the network interface or its driver.
The statistics do not behave the same way on all platforms.
might count packets whether they passed any filter set with
or not, or it might count only packets that pass the filter.
It also might, or might not, count packets dropped because there was no
room in the operating system's buffer when they arrived.
is not available on all platforms; it is zero on platforms where it's
not available. If packet filtering is done in libpcap, rather than in
the operating system, it would count packets that don't pass the filter.
might, or might not, count packets not yet read from the operating
system and thus not yet seen by the application.
might, or might not, be implemented; if it's zero, that might mean that
no packets were dropped by the interface, or it might mean that the
statistic is unavailable, so it should not be treated as an indication
that the interface did not drop any packets.
returns 0 on success and returns
if there is an error or if
doesn't support packet statistics. If
may be called with
as an argument to fetch or display the error text.
This document was created by
using the manual pages from "The Tcpdump Group" git repositories.
Time: 10:40:23 GMT, October 05, 2021
[Valid HTML 4.01]