NAME

eistat − show ei network interface statistics

SYNOPSIS

eistat [ − [ v ][ z ][ ctlr# ] [ kernel ] [ core ]

DESCRIPTION

eistat reports the statistics gathered by the kernel for the named interface.  These statistics are kept in the ei_softc structure. 

OPTIONS

ctlr# Select which ei interface’s statistics to display.  0 is the default. 

z Zero the statistics kept by the driver after printing their current values.  This option is available only to root.  This feature does not currently work. 

v Turn on verbose output.  This currently has no effect. 

kernel Extract name list from kernel rather than /vmunix. 

core Extract values from core rather than /dev/kmem. 

STATISTICS

The statistics reported by eistat are maintained by the kernel.  The statistics are:

Rev C,D LANCE extra byte problem: es_extrabyte
Historical, not maintained in 4.1A or later kernels.

Receive Framing Errors (dribble): es_fram
This counter is incremented every time a framing error is reported by the hardware.

Receive CRC Errors: es_crc
This is the total number of CRC errors detected by the hardware.

Receive overruns: es_oflo
Number of times the hardware input silo buffer overflowed.

Receive big packets: es_bigp
The number of illegally-large packets received.

Transmit underruns: es_uflo
The number of times the hardware output silo buffer underflowed.

Transmit w/at least one retry (collision): es_retries
Number of transmission attempts that failed due to collision.

Missed packets: es_missed
Packets missed by the hardware.

Babble errors: es_babble
Number of times the transmitter didn’t shut off after the maximum time for sending a packet.

Memory errors: es_merr
Number of memory errors encountered by the controller.

Rxoff errors: es_rxoff
Number of times that reception ended before the end of a packet.

Txoff errors: es_txoff
Number of times that transmission ended before the end of a packet.

Nonexistent heartbeats: es_noheartbeat
Total times that the hardware has complained about not seeing a network heartbeat.

BUFF bit in tmd occurrences: es_tBUFF
An internal consistency check in the chip has failed.  The BUFF flag should never be set in a transmission message descriptor.  This is a count of the number of such failures.

Transmit late collisions: es_tlcol
The number of times a collision occurred after the end of the expected collision period.  This usually indicates a slow network repeater.

Transmit retry failed after 16 times: es_trtry
Sixteen consecutive attempts to send a particular packet failed due to collisions.  This statistic is a count of the number of these complete failures.

No carrier errors: es_tnocar
A count of the times the controller has not detected hardware carrier.

Ledog() chip resets: es_dogreset
Count of the number of times the kernel has timed out waiting for the controller to do something.  The ‘dog’ is a watch-dog timer.

Freeze chip resets: es_reset
Number of times the chip has been reset due to it freezing.  XXX Need something clearer here.

Chip hung resets: es_hung
Count of controller hangs.  This is related to the es_dogreset count.

State of hang detection: es_hang_state
Determining whether or not the controller has hung is done by operating a state machine. es_hang_state is the current state the machine is in. 

Interrupts since last dog: es_intr
Count of interrupts that have been sent by the controller since the last controller reset.  This count not changing since the previous watch dog timer expiration is part of the determination of the controller having hung.

Interrupts during last dog: es_intr_lastdog
This is the value of es_intr at the time of the previous watch dog timer expiration.

Times through start with > 0 ready to go: es_started
This counter is incremented whenever the controller is given work to do.

Output dropped by unavailability of tmd’s: es_no_tmds
No hardware transmission message descriptors were available (i.e., the hardware transmit queue was full), so the packet was dropped.

Times we lost xmit sync with chip: es_tsync
There is a race condition in the LANCE chip where it asserts an error condition, and then clears the ownership flag on a tmd.  This counter is incremented every time this condition is detected, as it indicates a potential inconsistency (which is checked for and complained about separately).

Deferred transmission counter: es_defer
This counter tracks the number of times transmission has been deferred due to network unavailibility (in use or collision).

Output copy operations: es_outcpy
The number of times data has been copied from an mbuf chain to a hardware transmit buffer.

Input copy operations: es_incpy
The number of times data has been copied from a hardware reception buffer to an mbuf chain.

FILES

/usr/include/if/if_eivar.h

SEE ALSO

ei(4S), netstat(8C), iostat(8), egstat(8C)

BUGS

The −v and −z options aren’t actually implemented. 

Solbourne Computer, Inc.  —  2 December 1991