NAME

eistat − show ei network interface statistics

SYNOPSIS

eistat [ -v ] [ -d ] [ -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 currently has no effect. 

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

-d Display all LANCE descriptors and buffers from either a running system or from a core file. 

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.

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

State of hang detection: es_hang_state
Used by driver to determining whether or not the controller has hung.

Interrupts since last dog: es_intr
Count of interrupts that have been sent by the controller since the last controller reset.

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

Solbourne Computer, Inc.  —  10 Jan 1994