fddistat Command

Purpose

Shows FDDI device driver and device statistics.

Syntax

fddistat [ -r -t ] Device_Name

Description

The fddistat command displays the statistics that are gathered by the specified FDDI device driver. If no flags are specified, only the device driver statistics are displayed. This command is also invoked when the netstat command is run with the -v flag. The netstat command does not issue any fddistat command flags.

If an invalid Device_Name is specified, the fddistat command produces an error message stating that it might not connect to the device.

Flags

Table 1. Flags
Item	Description
-r	Resets all the statistics back to their initial values. This flag can be issued by privileged users only.
-t	Toggles debug trace in some device drivers.

Parameter

Table 2. Parameter
Item	Description
`Device_Name`	The name of the FDDI device, for example `fddi0`.

Statistic Fields

Note: Some adapters may not support a specific statistic. The value of nonsupported statistic fields is always 0.

The statistic fields that are displayed in the output of the fddistat command and their descriptions are:

Title Fields

Table 3. Title Fields
Item	Description
`Elapsed Time`	Displays the real time period is elapsed since the last time the statistics was reset. Since part of the statistics can be reset by the device driver during error recovery when a hardware error was detected, there might be another Elapsed Time that is displayed in the middle of the output when this situation occurred in order to reflect the time differences between the statistics.

Transmit Statistics Fields

Table 4. Transmit Statistics Fields
Item	Description
`Packets`	The number of packets transmitted successfully by the device.
`Bytes`	The number of bytes transmitted successfully by the device.
`Interrupt`	The number of transmit interrupts received by the driver from the adapter.
`Transmit Errors`	The number of output errors encountered on this device. This is a counter for unsuccessful transmissions due to hardware or network errors.
`Packets Dropped`	The number of packets accepted by the device driver for transmission, which were not (for any reason) given to the device.
`Max Packets on S/W Transmit Queue`	The maximum number of outgoing packets ever queued to the software transmit queue.
`S/W Transmit Queue Overflow`	The number of outgoing packets overflowed the software transmit queue.
`Current S/W+H/W Transmit Queue Length`	The number of pending outgoing packets on either the software transmit queue or the hardware transmit queue.
`Broadcast Packets`	The number of broadcast packets are transmitted without any error.
`Multicast Packets`	The number of multicast packets are transmitted without any error.

Receive Statistics Fields

Table 5. Receive Statistics Fields
Item	Description
`Packets`	The number of packets received successfully by the device.
`Bytes`	The number of bytes received successfully by the device.
`Interrupts`	The number of receive interrupts received by the driver from the adapter.
`Receive Errors`	The number of input errors encountered on this device. This is a counter for unsuccessful reception due to hardware or network errors.
`Packets Dropped`	The number of packets received by the device driver from this device, which were not (for any reason) given to a network demuxer.
`Bad Packets`	The number of bad packets received (that is, saved) by the device driver.
`Broadcast Packets`	The number of broadcast packets received without any error.
`Multicast Packets`	The number of multicast packets received without any error.

General Statistics Fields

Item	Description
`No mbuf Errors`	The number of times that mbufs were not available to the device driver. This usually occurs during receive operations when the driver must obtain mbuf buffers to process inbound packets. If the mbuf pool for the requested size is empty, the packet is discarded. The netstat -m command can be used to confirm this.
`SMT Error Word`	The adapter's SMT error status.
`SMT Event Word`	The adapter's SMT event status.
`Connection Policy Violation`	The status of the adapter's connection to the ring.
`Port Event`	The adapter's port status.
`Set Count`	The current set count value.
`Adapter Check Code`	The adapter's most recent adapter check status.
`Purged Frames`	Receive frames dropped by the adapter due to lack of available descriptors.
`ECM State Machine`	Entity Coordination Management State Machine.
`PCM State Machine: Port A`	Physical Connection Management for the primary adapter State Machine
`PCM State Machine: Port B`	Physical Connection Management for the secondary adapter State Machine
`CFM State Machine: Port A`	Configuration Management for the primary adapter State Machine
`CFM State Machine: Port B`	Configuration Management for the secondary adapter State Machine
`CF State Machine`	Overall Configuration State Machine.
`MAC CFM State Machine`	Configuration Management for the MAC State Machine.
`RMT State Machine`	Ring Management State Machine.
`Driver Flags`	The device driver internal status flags that are turned on.

Example

To display the device driver statistics for fddi0, enter:

fddistat fddi0

This produces the following output:

-------------------------------------------------------------
FDDI STATISTICS (fddi0) :
Elapsed Time: 0 days 0 hours 1 minutes 3 seconds

Transmit Statistics:                        Receive Statistics:
--------------------                        -------------------
Packets: 100                                Packets: 100
Bytes: 113800                               Bytes: 104700
Interrupts: 100                             Interrupts: 100
Transmit Errors: 0                          Receive Errors: 0
Packets Dropped: 0                          Packets Dropped: 0
Max Packets on S/W Transmit Queue: 0        Bad Packets: 0
S/W Transmit Queue Overflow: 0
Current S/W+H/W Transmit Queue Length: 0

Broadcast Packets: 0                        Broadcast Packets: 0
Multicast Packets: 0                        Multicast Packets: 0

General Statistics:
-------------------
No mbuf Errors: 0                            
SMT Error Word: 00040080                    SMT Event Word: 000004a0
Connection Policy Violation: 0000           Port Event: 0000
Set Count Hi: 0000                          Set Count Lo: 0003
Adapter Check Code: 0000                    Purged Frames: 0

ECM State Machine:        IN
PCM State Machine Port A: CONNECT
PCM State Machine Port B: ACTIVE
CFM State Machine Port A: ISOLATED
CFM State Machine Port B: CONCATENATED
CF State Machine:         C_WRAP_B
MAC CFM State Machine:    PRIMARY
RMT State Machine:        RING_OP

Driver Flags: Up Broadcast Running 
        Simplex DualAttachStation