pfstat(8)pfstat(8)Namepfstat - print packet filter status information
Syntax
/usr/bin/pfstat [ -cdfkpqsv01234567 ] [ system [ corefile ] ]
Description
The command interprets the data structures of the packet filter driver
If system is given, the required namelist is taken from there; other‐
wise, it is taken from If corefile is given, the data structures are
sought there, otherwise in (If corefile is a core dump, the option must
be given.)
Options
If no options are given, then all are assumed (except for the verbose
option, ).
c Counts. Displays various counts (per ethernet unit) including
number of packets sent and received, the number of packets
dropped due to full input queues, the number of packets not
wanted by any filter, and the number of packets missed by the
interface.
d Descriptors. Displays OpenDescriptors for each minor device.
f Filters. Displays packet filters for each minor device.
k Specifies the corefile is a crash dump, not a running system's
p Parameters. Displays device parameters including device type,
header and address lengths, maximum transmission units (MTU),
and interface and broadcast. addresses.
q QueueElements. Displays the QueueElements.
s Scavenger. Displays the FreeQueue and Scavenger statistics.
v Verbose. Displays information for minor devices not actually in
use and complete queue information, only if this flag is given.
<digit>
Limits output to information about specified units. If no digits
are given, all units are displayed.
Restrictions
Some of the output is a bit cramped to fit on an 80-character line. It
should be possible to get a less verbose but more readable listing.
Since things happen quickly, it is not likely that will provide a con‐
sistent view of a running system. It is mostly useful for analyzing
static or slowly-varying problems, not transient ones.
Output Format
This section describes the information displayed in the output of the
command under the headings and
# Minor device number for open descriptor.
LOC Descriptor location.
LINK-QUEUE Forward link to other descriptors.
STATE Blank, or one of:
wait waiting for input, indefinite wait
timed waiting for input, timed wait
tout has timed out
WAIT-QUEUE Addresses of ``Queue Elements'' for waiting packets.
NQ'D Number of packets queued for input/maximum for this
queue.
TOUT Timeout duration in clock ticks (if the [Verbose]
option is not given, then times may be expressed as
minutes [with a trailing ``m''], hours [with a
trailing ``h''], or simply ``long'', to keep the
columns lined up.)
MODE Shows which mode bits are set for the minor device;
each bit is encoded as a single character:
H ENHOLDSIG
B ENBATCH
T ENTSTAMP
P ENPROMISC
N ENNONEXCL
C ENCOPYALL
? An unknown mode bit is set.
SIG Signal number to be delivered when a packet arrives.
PROC Process to be signaled when a packet arrives.
PID Process id which enabled the signal.
# Minor device number of filter.
COUNT Count of packets accepted by this filter.
DROPS Count of ``recent'' drops for this filter.
PRI Priority of filter.
LEN Length of filter (in shortwords).
FILTER See for interpretation of packet filters.
LOC Location of queue element.
LINK-QUEUE Forward and backward links.
COUNT Packet size.
REF Reference count for queue element.
FLAGS Per-packet flag bits set; each bit is encoded as a
single character:
P ENSF_PROMISC
B ENSF_BROADCAST
M ENSF_MULTICAST
T ENSF_TRAILER
? An unknown flag bit is set.
DROP Count of packets dropped between the time previous
packet was queued and the time this packet was
queued.
TIME Approximate time this packet was received.
Files
Namelist
Default source of tables
See Alsonetstat(1), packetfilter(4), pfconfig(8c), pstat(8)pfstat(8)
