unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



pfstat(1)							    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)