Index Index for
Section 1
Index Alphabetical
listing for P
Bottom of page Bottom of
page

pfstat(1)

NAME

pfstat - Print packet filter status information

SYNOPSIS

/usr/bin/pfstat [options]

OPTIONS

If no options are given, all are assumed (except for the verbose option, -v). -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. -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 option is given. -digit Limits output to information about specified units. If no digits are given, all units are displayed. Valid digits are 0 to 7.

DESCRIPTION

The pfstat command interprets the data structures of the packet filter driver packetfilter(7). The data structures are contained in /dev/kmem.

RESTRICTIONS

By default, some of the output might not be easily read on an 80-character line. You might want to use some of the options to obtain a less verbose but more readable listing. Because of the dynamic nature of a running system, pfstat might not provide a consistent view of the system. You should use this command for analyzing static or slowly-varying problems, not transient ones.

OUTPUT FORMAT

This section describes the information displayed in the output of the pfstat command under the headings AllDescriptors, Filters, and QueueElts. AllDescriptors # Minor device number for open descriptor. LOC Descriptor location. LINK-QUEUE Forward link to other descriptors. STATE Blank, or one of the following: 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 -v [Verbose] option is not given, the 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 b ENBPFHDR ? 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. Filters # 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. (Not applicable to BPF-style filters.) LEN Length of filter (in shortwords). FILTER See packetfilter(7) for interpretation of packet filters. See bpf(7) for interpretation of BPF-style filters. QueueElts 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

/dev/kmem Default source of tables

SEE ALSO

Commands: netstat(1), pfconfig(8) Files: bpf(7), packetfilter(7)

Index Index for
Section 1
Index Alphabetical
listing for P
Top of page Top of
page