pfstat(8)						      System Manager's Manual							 pfstat(8)

Name
       pfstat - 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; oth-
       erwise, 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 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 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 Also
       netstat(1), packetfilter(4), pfconfig(8c), pstat(8)

																	 pfstat(8)