pfstat(1) [osf1 man page]
pfstat(1) General Commands Manual 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). Counts. Displays various counts (per ethernet unit) includ- ing 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. Descriptors. Displays OpenDescriptors for each minor device. Filters. Dis- plays 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 addresses. QueueElements. Displays the QueueElements. Scavenger. Displays the FreeQueue and Scavenger statistics. Verbose. Displays information for minor devices not actually in use and complete queue informa- tion, only if this option is given. 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. 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 Addresses 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, 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.) 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 filter. Count of ``recent'' drops for this filter. Priority of filter. (Not applicable to BPF-style filters.) Length of filter (in shortwords). 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_MULTICAST 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
Default source of tables SEE ALSO
Commands: netstat(1), pfconfig(8) Files: bpf(7), packetfilter(7) pfstat(1)
Check Out this Related Man Page
pfconfig(8) System Manager's Manual pfconfig(8) NAME
pfconfig - Configure packet filter parameters SYNOPSIS
/usr/sbin/pfconfig [+/-p[romisc]] [+/-c[opyall]] [-b[acklog] nnn] [-a[ll]] [interface-name...] DESCRIPTION
The pfconfig command allows the system manager to configure certain parameters of the packet filter driver (see packetfilter(7)). These parameters are configured separately for each interface; the interfaces are specified by name on the command line (for example, ln0, and ni1). If more than one interface is specified, they are all given the same settings. Alternatively, you can specify -all to configure all the packet-filter interfaces on the system. You can set the following parameters with pfconfig: Allows packet filter users to set the interface into promiscuous mode (receives all packets). Whenever there is at least one packet filter descriptor open with the ENPROMISC mode bit set, the interface is put into promis- cuous mode. When no such descriptors are in use, the interface is returned to normal mode. The interface is no longer put into promiscu- ous mode on behalf of packet filter users; if the interface is in promiscuous mode when this command is given, it is returned to normal mode. (The superuser may use ifconfig(8) to control promiscuous mode, overriding the mode set by non-superusers. This is the default set- ting.) Allows packet filter users to set the interface into copy-all mode (receives packets sent/received by the kernel-resident protocol software [for example, IP, ARP, DECnet, LAT] on this host). Whenever there is at least one packet filter descriptor open with the ENCOPYALL mode bit set, the interface is put into copy-all mode. When no such descriptors are in use, the interface is returned to normal mode. The interface is no longer put into copy-all mode on behalf of packet filter users; if the interface is in copy-all mode when this command is given, it is returned to normal mode. (The superuser may use ifconfig(8) to control copy-all mode, overriding the mode set by non-supe- rusers. This is the default setting.) Sets the maximum backlog (packet filter input queue length) for non-superuser descriptors to the specified number. When a descriptor is opened, it is given a queue length limit of two. An application can increase this backlog using the EIOCSETW ioctl request. Superusers are allowed to increase their backlog up to a system-wide maximum; non-superusers are allowed to increase their backlog only up to the maximum set by this program. Note that allowing too large a backlog may result in vast amounts of kernel memory being tied up in the packet filter driver queues. If no configuration parameters are specified, the pfconfig command displays the current packet filter configuration for the network interfaces. Only the superuser may use this command to change the configuration. DIAGNOSTICS
PACKETFILTER option is not built into the running kernel Explanation: Packetfilter support is not built into the kernel. Reconfigure the kernel with the packetfilter option. pfopen: xxx: No such device Explanation: The specified network device does not exist on the system, or no pfilt minor devices exist in the /dev/pf directory. pfconfig: your system may not be properly configured; see "man packetfilter" Explanation: No pfilt minor devices exist in the /dev/pf directory. pfconfig: either network interface 'xxx' is down, or your system may not be properly configured; see "man packfilter" Explanation: The specified network device is not up and running. pfconfig: either all of your network interfaces are down, or your system may not be properly configured; see "man packfilter" Explanation: No network devices are up and running. SEE ALSO
Commands: intro(1), netstat(1), pfstat(1), ifconfig(8) Files: inet.local(4), bpf(7), packetfilter(7) pfconfig(8)