NAME

egstat − show eg network interface statistics

SYNOPSIS

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

DESCRIPTION

egstat reports the statistics gathered by the kernel for the named interface. 

OPTIONS

ctlr# Select which eg 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, and even so doesn’t actually 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 egstat are separated into two categories: driver and firmware.  Firmware statistics are maintained by the hardware interface, and driver statistics are kept by the kernel.  Since the firmware statistics are garnered directly from the hardware, they are not available from crash dumps. 

Driver Statistics:

Pending transmits (eg_tx_sent)
This is the number of packets on the transmit queue.  These packets are waiting for transmission by the hardware.  The size of the queue is limited by the constant EG_TX_THROTTLE, defined in if_egvar.h.

Hung receives (eg_rx_sent)
The number of buffers that have been given to the controller for incoming packets.  The size of the queue is limited by the constant EG_RX_THROTTLE, defined in if_egvar.h.

Current loaned receives (eg_rloan_out)
The number of packet buffers on the interface that are currently borrowed by the kernel.  This is done to avoid copying from the interface into main memory, thus saving some time.

Total loaned receives (eg_rloans)
This is a cumulative total of buffers that have been loaned out.  It is never decremented.

Big packet resets (eg_reset_count)
The controller gets confused when it sees an illegally-large packet. When the driver detects this, it resets the controller and increments this counter.

Max CRBs per interrupt (eg_max_crb)
The largest number of Command Response Blocks that may be processed in a single interrupt.

stat (eg_stat_pad1..4)
These fields are not currently used, and are reported only for completeness.

Firmware Statistics:

Incoming TX IOPBs (csb_TX_ATT)
The total number of attempted frame transmissions (successful or not).

DMA completions (csb_TX_DMA)
Total number of DMA’s completed as a result of a transmit command.

LANCE TX interrupts (csb_TX_INTR)
Total number of frames transmitted by the LANCE chip.

Good TXs (csb_TX_GOOD)
Total number of frames successfully transmitted.

TXs with errors (csb_TX_ERR)
Total number of unsuccessful frame transmissions.

TX dones posted (csb_TX_DONE)
Total number of frame transmission completions reported to the host.

RX attempted (csb_RX_ATT)
Total number of attempted message receptions (successful or not).

Missed packets due to no IOPB (csb_RX_STARVE)
Number of frame receptions lost or ignored because the driver had not requested that packets be received.  This request must be made on a regular basis by the driver.

LANCE RX interrupts (csb_RX_INTR)
Total number of frames received by the LANCE chip.

Good RXs (csb_RX_GOOD)
Total number of messages successfully received.

RXs with errors (csb_RX_ERR)
Total number of messages unsuccessfully received.

RX DMA completions (csb_RX_DMA)
Total number of DMA’s completed as a result of a receive command from the driver.

RX Dones posted (csb_RX_DONE)
Total number of receive commands reported to the driver.

MISC DMAs (csb_MISC_DMA)
This field is not defined.

LANCE Interrupts (csb_MISC_DMA)
Total number of attempted LANCE interrupts serviced.  These interrupts are internal to the controller - they are not seen by the host system.

CSR errors (csb_CSR0_ERR)
Total number of babble, collision, and miss errors.

babbles (csb_CSR0_BABL)
Total number of times the LANCE chip reported that the transmitter was on longer than the time required to transmit the longest allowable frame (1519 bytes).

collisions (csb_CSR0_CERR)
Total number of times the LANCE chip reported packet collisions.

missed packet errors (csb_CSR0_MISS)
Total number of times the LANCE chip reported that it missed a message because it did not have an available buffer.

memory errors (csb_CSR0_MERR)
Total number of times the LANCE chip reported a timeout on an internal memory transfer during a transmit operation.

FILES

/usr/include/if/if_egvar.h

/usr/include/if/if_egstruct.h

SEE ALSO

eg(4S), netstat(8C), iostat(8), eistat(8C)

BUGS

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

Solbourne Computer, Inc.  —  2 December 1991