Manual Page Result
0
Command: pfstat | Section: 1 | Source: Digital UNIX | File: pfstat.1.gz
pfstat(1) General Commands Manual pfstat(1)
NAME
pfstat - Print packet filter status information
SYNOPSIS
/usr/bin/pfstat [ options ] [ system ]
DESCRIPTION
The pfstat command interprets the data structures of the packet filter
driver packetfilter(7). The data structures are contained in
/dev/kmem. If system is given, the required namelist is taken from
there; otherwise, it is taken from /vmunix.
FLAGS
If no options are given, then all are assumed (except for the verbose
option, -v). Counts. Displays various counts (per ethernet unit) in-
cluding 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. De-
scriptors. Displays OpenDescriptors for each minor device. Filters.
Displays packet filters for each minor device. Parameters. Displays
device parameters including device type, header and address lengths,
maximum transmission units (MTU), and interface and broadcast ad-
dresses. QueueElements. Displays the QueueElements. Scavenger. Dis-
plays the FreeQueue and Scavenger statistics. Verbose. Displays in-
formation for minor devices not actually in use and complete queue in-
formation, only if this flag is given. Limits output to information
about specified units. If no digits are given, all units are displayed.
Valid digits are 0 to 7.
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 pfstat will provide
a consistent view of a running system. It is mostly useful for analyz-
ing 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. Descriptor location. Forward
link to other descriptors. Blank, or one of the following: Waiting for
input, indefinite wait Waiting for input, timed wait Has timed out Ad-
dresses of ``Queue Elements'' for waiting packets. Number of packets
queued for input/maximum for this queue. Timeout duration in clock
ticks (if the -v [Verbose] option is not given, then times may be ex-
pressed as minutes [with a trailing ``m''], hours [with a trailing
``h''], or simply ``long'', to keep the columns lined up.) Shows which
mode bits are set for the minor device; each bit is encoded as a single
character: ENHOLDSIG ENBATCH ENTSTAMP ENPROMISC ENNONEXCL ENCOPYALL
ENBPFHDR An unknown mode bit is set. Signal number to be delivered
when a packet arrives. Process to be signaled when a packet arrives.
Process id which enabled the signal.
Filters
Minor device number of filter. Count of packets accepted by this fil-
ter. Count of ``recent'' drops for this filter. Priority of filter.
(Not applicable to BPF-style filters.) Length of filter (in short-
words). See packetfilter(7) for interpretation of packet filters. See
bpf(7) for interpretation of BPF-style filters.
QueueElts
Location of queue element. Forward and backward links. Packet size.
Reference count for queue element. Per-packet flag bits set; each bit
is encoded as a single character: ENSF_PROMISC ENSF_BROADCAST ENSF_MUL-
TICAST ENSF_TRAILER An unknown flag bit is set. Count of packets
dropped between the time previous packet was queued and the time this
packet was queued. Approximate time this packet was received.
FILES
Namelist Default source of tables
RELATED INFORMATION
Commands: netstat(1), pfconfig(8)
Files: bpf(7), packetfilter(7) delim off
pfstat(1)