DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5 and SCO OpenServer

mac_stats_eth(D4mdi)


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:

mac_badlen
mac_align
mac_badsum
mac_frame_nosr
mac_baddma
mac_colltable

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

 +------------+------+----+---+---+-----+----+
 |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.

Hardware applicability

All

Version applicability

mdi: 1, 2, 2.1

Standards conformance

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.

References

MACIOC_GETSTAT
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005