mac_stats_eth --
Ethernet statistics structure for the MACIOC_GETSTAT ioctl
Syntax
typedef struct mac_stats_eth {
ulong mac_align; /* Bad Alignment Received */
ulong mac_badsum; /* Bad Checksum Received */
ulong mac_sqetesterrors; /* SQE Test Errors */
ulong mac_frame_def; /* #Frames Deferred (not dropped) */
ulong mac_oframe_coll; /* #Times coll' det'ed >512bits
* into frame */
ulong mac_xs_coll; /* #Frames(TX) dropped due to * excessive collisions */
ulong mac_tx_errors; /* #Internal MAC Transmit Errors */
ulong mac_carrier; /* #Frames Dropped(TX) Due To Lost
* carrier */
ulong mac_xs_def; /* #Frames(TX) Dropped due to Excess
* Deferral */
ulong mac_badlen; /* #Frames(rx) Dropped due to * PDU_SZ>MAX_MACPDU_SZ */
ulong mac_no_resource; /* #Internal MAC Receive Errors */
/* Table of #Frames involved in N collisions, where */
/* N-1 is the table index (e.g. mac_colltable[0] ==
/* #Frames involved in 1 collision) */
ulong mac_colltable[16];
/* FIELDS NOT REQUIRED BY MIB */
ulong mac_spur_intr; /* Spurious interrupts */
ulong mac_frame_nosr; /* Dropped Due To Lack of STREAMS */
ulong mac_baddma; /* Errors Due To Over/Under Runs */
ulong mac_timeouts; /* Device Time-outs */
} mac_stats_eth_t;
Description
Ethernet and IEEE 802.3 CSMA/CD
MAC frames are both used on Ethernet-style network
media. Therefore, MDI drivers that drive these types
of adapters must be able to send and receive both types.
Arguments
mac_align
A count of the frames received on a particular interface that are not an
integral number of octets in length and do not pass the FCS check.
mac_badsum
A count of the frames received on a particular interface that are an integral
number of octets but do not pass the FCS check.
mac_sqetesterrors
A count of the times that the SQE TEST ERROR message is generated by
the PLS sub layer for a particular interface. The SQE TEST ERROR message is defined in IEEE, "Carrier Sense Multiple Access with
Collision Detection (CSMA/CD) Access Method and Physical Layer
Specifications", ANSI/IEEE Std 802.3-1985.
mac_frame_def
A count of the frames for which the first transmission attempt on a particular
interface is delayed because the medium is busy. The count does not include
frames involved in collisions.
mac_oframe_coll
The number of times that a collision is detected on a particular interface
later than 512 bit-times into the transmission of a packet. 512 bit-times
corresponds to 51.2 microseconds on a 10Mb/s system. A (late) collision is
included in this count is also considered as a (generic) collision for
purposes of other collision-related statistics.
mac_xs_coll
A count of frames for which transmission on a particular interface fails due to excessive collisions.
mac_tx_errors
A count of frames for which the transmission on a particular interface fails
due to an internal MAC sub layer transmit error. A frame is only
counted here if it is not counted by any of:
mac_oframe_coll
mac_xs_coll
mac_xs_def
mac_carrier
The number of times that the carrier sense condition was lost or never asserted
when attempting to transmit a frame on a particular interface. The count is
incremented at most once per transmission attempt, even if the carrier sense
condition fluctuates during a transmission attempt.
mac_xs_def
A count of the frames for which transmission on a particular interface is
deferred for an excessive period of time.
mac_badlen
A count of frames received on a particular interface that exceed the maximum permitted frame size.
mac_no_resource
A count of frames for which reception on a particular interface fails due to
an internal MAC sub layer receive error. A frame is only counted
here if it is not counted by:
This array represents the frequency of individual MAC frames for
which the transmission (successful or otherwise) on a particular interface is
accompanied by a particular number of media collisions. The index into the
array is the number of collisions-1. For example mac_colltable[0] counts the
number of frames involved in exactly one collision during transmission.
Array Index
0
1
2
3
...
15
#collisions
1
2
3
4
...
16
E.g.
1000
40
3
0
...
0
mac_spur_intr
A count of .interrupts received by the MDI driver which did not
appear to be generated by the network adapter.
mac_frame_nosr
A count of frames for which reception on a particular interface fails due to no STREAMS messages being available.
mac_baddma
A count of frames for which reception on a particular interface fails due to
DMA over/under runs between the NIC and the bus interface.
For adapters using a shared memory based bus interface this counter should be
used to record the number of frames lost due to the shared memory receive
buffer area becoming full.
mac_timeouts
A count of the times that the network adapter failed to generate an expected
transmit complete interrupt.
This structure definition is driven by the SNMP MIB definition
for Ethernet. The MIB definition can be found in the
IAB Network Working Group's RFC 1284.