Click this button to go to the index for this section.

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).

  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 flag 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.

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 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, 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

      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.




  #   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.




  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
  /vmunix
      Namelist

  /dev/kmem
      Default source of tables

RELATED INFORMATION
  Commands: netstat(1), pfconfig(8)


  Files: bpf(7), packetfilter(7)