The "DMA Overrun" statistic is incremented when the
adapter is DMAing a packet to system memory and the
transfer is not completed. There are system buffers
available for the packet to be DMAed into, but the
DMA operation failed to complete. This occurs when
the MCA bus is too busy for the adapter to be able OID
to DMA the packets. The location of the adapter on BDC
the bus matters in a heavily loaded system.
Typically an adapter "earlier" (lower slot number)
on the bus, by having the higher bus priority, is PAGE
using so much of the bus that adapters "later" on 7
the bus are starved. This is particularly true if OF
the "earlier" adapters are ATM or SSA adapters. 10
Customer said that notice he was getting 256 failures
I suggest he do following when this happen.
crash
> od kememsize 1 D (memory in use by bytes)
184,510,656 OID
> od allocated 1 D (memory pinned by bytes) BDC
188,000,000
>od thewall 1 D (memory for communication buffer in kbytes)
at this time it was ok PAGE
I suggest he do a 9
vmstat 10 10 OF
ps aux 10
lsps -a
when he has problem again he
also got ssa error
He still hasn't put on latest ethernet driver he will put
on driver.
Description
The tokstat displays the statistics gathered by the specified
token-ring device driver. The user can optionally specify that the
device-specific statistics be displayed in addition to the device
driver statistics. If no flags are specified, only the device driver
statistics are displayed.
This tokstat command is also invoked when the command is
run with the "-v" flag. The command does not issue any
tokstat command flags.
If an invalid device name is specified, the tokstat command will
produce an error message stating that it could not connect to the
device.
Flags
d Displays all the device driver statistics, including the
device-specific statistics.
r Resets all the statistics back to their initial values. This
flag can only be issued by privileged users.
Parameters
device_name The name of the token-ring device, for example, tok0.
Examples
1. To display the device driver statistics for tok0, enter:
tokstat tok0
This produces the following output:
-------------------------------------------------------------
TOKEN-RING STATISTICS (tok0) :
Device Type: Token-Ring High-Performance Adapter (8fc8)
Hardware Address: 10:00:5a:4f:26:c1
Elapsed Time: 0 days 0 hours 8 minutes 33 seconds
Transmit Statistics: Receive Statistics:
-------------------- -------------------
Packets: 191 Packets: 8342
Bytes: 17081 Bytes: 763227
Interrupts: 156 Interrupts: 8159
Transmit Errors: 0 Receive Errors: 0
Packets Dropped: 0 Packets Dropped: 0
Max Packets on S/W Transmit Queue: 17 Bad Packets: 0
S/W Transmit Queue Overflow: 0
Current S/W+H/W Transmit Queue Length: 0
Broadcast Packets: 1 Broadcast Packets: 8023
Multicast Packets: 0 Multicast Packets: 0
Timeout Errors: 0 Receive Congestion Errors: 0
Current SW Transmit Queue Length: 0
Current HW Transmit Queue Length: 0
General Statistics:
-------------------
No mbuf Errors: 0 Lobe Wire Faults: 0
Abort Errors: 0 AC Errors: 0
Burst Errors: 0 Frame Copy Errors: 0
Frequency Errors: 0 Hard Errors: 0
Internal Errors: 0 Line Errors: 0
Lost Frame Errors: 0 Only Station: 0
Token Errors: 0 Remove Received: 0
Ring Recovered: 0 Signal Loss Errors: 0
Soft Errors: 0 Transmit Beacon Errors: 0
Driver Flags: Up Broadcast Running
AlternateAddress ReceiveFunctionalAddr
2. To display the token-ring device driver statistics and the
token-ring device-specific statistics for tok0, enter:
tokstat -d tok0
This produces the following output:
-------------------------------------------------------------
TOKEN-RING STATISTICS (tok0) :
Device Type: Token-Ring High-Performance Adapter (8fc8)
Hardware Address: 10:00:5a:4f:26:c1
Elapsed Time: 0 days 2 hours 48 minutes 38 seconds
Transmit Statistics: Receive Statistics:
-------------------- -------------------
Packets: 389 Packets: 153216
Bytes: 42270 Bytes: 14583150
Interrupts: 354 Interrupts: 151025
Transmit Errors: 0 Receive Errors: 0
Packets Dropped: 0 Packets Dropped: 0
Max Packets on S/W Transmit Queue: 17 Bad Packets: 0
S/W Transmit Queue Overflow: 0
Current S/W+H/W Transmit Queue Length: 0
Broadcast Packets: 1 Broadcast Packets: 152642
Multicast Packets: 0 Multicast Packets: 0
Timeout Errors: 0 Receive Congestion Errors: 0
Current SW Transmit Queue Length: 0
Current HW Transmit Queue Length: 0
General Statistics:
-------------------
No mbuf Errors: 0 Lobe Wire Faults: 0
Abort Errors: 0 AC Errors: 0
Burst Errors: 0 Frame Copy Errors: 0
Frequency Errors: 0 Hard Errors: 0
Internal Errors: 0 Line Errors: 0
Lost Frame Errors: 0 Only Station: 0
Token Errors: 0 Remove Received: 0
Ring Recovered: 0 Signal Loss Errors: 0
Soft Errors: 0 Transmit Beacon Errors: 0
Driver Flags: Up Broadcast Running
AlternateAddress ReceiveFunctionalAddr
Token-Ring High-Performance Adapter (8fc8) Specific Statistics:
--------------------------------------------------------------
DMA Bus Errors: 0 DMA Parity Errors: 0
ARI/FCI Errors: 0
Notes
There may be statistics that are not supported by some of
the adapters. The not-supported field will always be 0.
The following lists the descriptions for each field of the
statistics output:
Title:
Device Type - Displays the description of the adapter type.
Hardware Address - Displays the Token-Ring network address currently used
by the device.
Elapsed Time - Displays the real time period has elapsed since the last time
the statistics was reset. Since part of the statistics
may be reset by the device driver during error recovery
when a hardware error was detected, there will be another
Elapsed Time displayed in the middle of the output when
this situation has occurred in order to reflect the
time differences between the statistics.
Transmit Statistics:
Packets - This field shows the number of packets that have been transmitted
successfully by the device.
Bytes - This field shows the number of bytes that have been transmitted
successfully by the device.
Interrupts - This field shows the number of transmit interrupts that have
been received by the driver from the adapter.
Transmit Errors - This field shows the number of output errors encountered
on this device. This is a counter for unsuccessful
transmissions due to hardware/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 that have been
transmitted without any error.
Multicast Packets - The number of multicast packets that have been
transmitted without any error.
Timeout Errors - This field shows the number of unsuccessful transmissions
due to timeout errors.
Current SW Transmit Queue Length - This field shows the number of outgoing
packets currently on the software
transmit queue.
Current HW Transmit Queue Length - This field shows the number of outgoing
packets currently on the hardware
transmit queue.
Receive Statistics:
Packets - This field shows the number of packets that have been received
successfully by the device.
Bytes - This field shows the number of bytes that have been received
successfully by the device.
Interrupts - This field shows the number of receive interrupts that have
been received by the driver from the adapter.
Receive Errors - This field shows the number of input errors encountered
on this device. This is a counter for unsuccessful
reception due to hardware/network errors.
Packets Dropped - This field shows 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 - This field shows the number of bad packets received (i.e.
saved) by the device driver.
Broadcast Packets - The number of broadcast packets has been received
without any error.
Multicast Packets - The number of multicast packets has been received
without any error.
Receive Congestion Errors - This field shows the number of incoming packets
dropped by the hardware due to a no resource
error.
General Statistics:
No mbuf Errors - This field shows the number of times that mbufs were not
available to the device driver.
Lobe Wire Faults - This field shows the number of times that the adapter
has detected an open or short circuit in the lobe data
path (ie. the cable is unplugged).
Abort Errors - This field shows the number of times that the adapter
has had a problem transmitting.
AC Errors - This field shows the number of times that the adapter
received more than one AMP (Active Monitor Present) or SMP
(Standby Monitor Present) frame which had the address recognized
and frame copied bits set to zero. This indicates a problem
with neighbor notification. Every station learns and remembers
who its Nearest Active Upstream Neighbor (NAUN) is from AMP and
SMP frames. When a station reports a problem, it also reports
who its NAUN is. This helps to define the "fault domain".
Burst Errors - This field shows the number of times that the adapter
has detected that the polarity of the signal didn't switch
like it is supposed to.
Frame Copy Errors - This field shows the number of times that the adapter
has detected that a frame with its specific address has
been copied by another adapter.
Frequency Errors - This field shows the number of times that the adapter
has detected that the frequency of the incoming signal
differs from the expected frequency by more than that
allowed by the IEEE 802.5 standard. Check the active
monitor that is responsible for master clocking the ring
and compensating for frequency jitter.
Hard Errors - This field shows the number of times that the adapter
has either transmitted or received a beacon MAC frame.
Internal Errors - This field shows the number of times that the adapter
had an internal error.
Line Errors - This field shows the number of times that the adapter
detected an invalid character in a frame or token.
Lost Frame Errors - This field shows the number of times that the adapter
transmitted a frame and failed to receive it back.
Only Station - This field shows the number of times that the adapter
has sensed that it is the only adapter on the ring.
Token Errors - This field shows the number of times that the adapter
acting as an active monitor detected that the token got lost.
This may just be due to ring reconfiguration. If this occurs
often, check to see if other soft errors indicate a specific
problem.
Remove Received - This field shows the number of times that the adapter
has received a Remove Ring Station MAC frame request.
Ring Recovered - This field shows the number of times that the ring has been
purged and is being recovered back into a normal operating
state.
Signal Loss Errors - This field shows the number of times that the adapter
has detected the absence of a receive signal.
Soft Errors - This field shows the number of times that the adapter
has detected a soft error (recoverable by the MAC layer
protocols).
Transmit Beacon Errors - This field shows the number of times that the adapte
has transmitted a beacon frame.
Driver Flags - This field shows the device driver internal status flags
that are currently turned on.
Device Specific Statistics:
This part of the display may be different for each type of the adapter.
It may contain adapter specific information and some extended statistics
that were not included in the generic statistics. Some adapters may not
have any device specific statistics.
Device Specific Statistics:
This part of the display may be different for each type of the adapter.
It may contain adapter specific information and some extended statistics
that were not included in the generic statistics. Some adapters may not
have any device specific statistics. The following lists the descriptions
for some fields that MAY be listed in this section:
ARI/FCI Errors - This field shows the number of times that the adapter
received more than one Ring Poll MAC frame with ARI/FCI
equal to zero without first receiving an intervening
Ring Poll Request MAC frame. This indicates that the
upstream adapter is unable to set its ARI/FCI bits in a
frame that it has transmitted.
DMA Bus Errors - This field shows the number of times that the adapter
has completed a DMA transfer and detected a bus error.
DMA Parity Errors - This field shows the number of times that the adapter
has completed a DMA transfer and detected a parity error.
Receive Overruns - This field shows the number of times that the adapter
receive FIFO was full when the adapter tried to receive
a frame.
Receive Underruns - This field shows the number of times that the adapter
transmit FIFO was empty before the end of frame symbol
was detected.
Related Information
The command. The entstat command. The fddistat command.
=============================================================================
=============================================================================
(18) Writer: This is a complete replacement of item (17).
I was asked to add more info to the tokstat command manpage.
These changes from item (16) start with the Device Specific Statistics
section at the end of the definition in item (16). Gary Decker 8-3527
Device Specific Statistics:
This part of the display may be different for each type of the adapter.
It may contain adapter specific information and some extended statistics
that were not included in the generic statistics. Some adapters may not
have any device specific statistics. The following lists the descriptions
for some fields that MAY be listed in this section:
ARI/FCI Errors - This field shows the number of times that the adapter
received more than one Ring Poll MAC frame with ARI/FCI
equal to zero without first receiving an intervening
Ring Poll Request MAC frame. This indicates that the
upstream adapter is unable to set its ARI/FCI bits in a
frame that it has transmitted.
DMA Bus Errors - This field shows the number of times that the adapter
has completed a DMA transfer and detected a bus error.
DMA Parity Errors - This field shows the number of times that the adapter
has completed a DMA transfer and detected a parity error.
Receive Overruns - This field shows the number of times that the adapter
receive FIFO was full when the adapter tried to receive
a frame.
Receive Underruns - This field shows the number of times that the adapter
transmit FIFO was empty before the end of frame symbol
was detected.
Number of read log commands issued - This field shows the number of times
that an adapter error counter has
overrun (reached 255) and the device
driver has issued a read log command
to read (and reset) the error counters.