entstat command
Purpose
Shows Ethernet device driver and device statistics.
Syntax
entstat [ -all ] [ -reset ] Device_Name
Description
The entstat command displays the statistics that are gathered by the specified Ethernet device driver. The user can optionally specify that the device-specific statistics be displayed in addition to the device generic statistics. If no flags are specified, only the device generic statistics are displayed.
Flags
| Flag name | Description |
|---|---|
| -all | Displays all the statistics, including the device-specific statistics. |
| -reset | Resets all the statistics back to their initial values. |
Parameters
| Parameter name | Description |
|---|---|
| Device_name | The name of the Ethernet device, for example, ent0. |
Exit Status
The statistic fields that are displayed in the output of the entstat command and their
descriptions are as follows.
Note: Some adapters might not support a specific statistic. The value
of non-supported statistic fields is always 0.
Title Fields
| Field name | Description |
|---|---|
| Device Type | Displays the description of the adapter type. |
| Hardware Address | Displays the Ethernet network address that is currently used by the device. |
| Elapsed Time | Displays the real time that has elapsed since last time the statistics were reset. Part of the statistics might be reset by the device driver during error recovery when a hardware error is detected. Another Elapsed Time value is displayed in the middle of the output when this situation occurs, to reflect the time difference between the statistics. |
Transmit Statistics Fields
| Field name | Description |
|---|---|
| Packets | The number of packets that are transmitted successfully by the device. |
| Bytes | The number of bytes transmitted successfully by the device. |
| Interrupts | The number of transmit interrupts that are received by the driver from the adapter. |
| Transmit Errors | The number of output errors that are encountered on this device. This is a counter for unsuccessful transmissions due to hardware or network errors. |
| Packets Dropped | The number of packets that are accepted by the device driver for transmission that were not (for any reason) given to the device. |
| Max Packets on S/W Transmit Queue | The maximum number of outgoing packets ever queued to the software transmit queue. |
| S/W Transmit Queue Overflow | The number of outgoing packets that have overflowed the software transmit queue. |
| Current S/W+H/W Transmit Queue Length | The number of pending outgoing packets on either the software transmit queue or the hardware transmit queue. |
| Broadcast Packets | The number of broadcast packets that are transmitted without any error. |
| Multicast Packets | The number of multicast packets that are transmitted without any error. |
| No Carrier Sense | The number of unsuccessful transmissions due to the no carrier sense error. |
| DMA Underrun | The number of unsuccessful transmissions due to the DMA underrun error. |
| Lost CTS Errors | The number of unsuccessful transmissions due to the loss of the Clear-to-Send signal error. |
| Max Collision Errors | The number of unsuccessful transmissions due to too many collisions. The number of collisions encountered exceeds the number of retries on the adapter. |
| Late Collision Errors | The number of unsuccessful transmissions due to the late collision error. |
| Deferred | The number of outgoing packets that are deferred during transmission. Deferred means that the adapter had to defer while trying to transmit a frame. This condition occurs if the network is busy when the adapter is ready to transmit. The adapter defers only the first attempt to send a packet. After that the adapter transmits the packet without checking. If the network is still busy, a collision is recorded. |
| SQE Test | Contains the number of "Signal Quality Error" Tests (that is, Heartbeat) performed successfully during transmission. |
| Timeout Errors | The number of unsuccessful transmissions due to adapter reported timeout errors. |
| Single Collision Count | The number of outgoing packets with single (only one) collision that is encountered during transmission. |
| Multiple Collision Count | The number of outgoing packets with multiple (2 - 15) collisions that are encountered during transmission |
| Current HW Transmit Queue Length | The number of outgoing packets that currently exist on the hardware transmit queue. |
| CRC Errors | The number of incoming packets with the Checksum (FCS) error. |
| DMA Overrun | The number of incoming packets with the DMA overrun error. |
| Alignment Errors | The number of incoming packets with the alignment error. |
| No Resource Errors | The number of incoming packets dropped by the hardware due to the no resource error. This error usually occurs because the receive buffers on the adapter were exhausted. Some adapters might have the size of the receive buffers as a configurable parameter. Check the device configuration attributes for possible tuning information. |
| Receive Collision Errors | The number of incoming packets with the collision errors during the reception. |
| Packet Too Short Errors | The number of incoming packets with the length error to indicate that the packet size is less than the Ethernet minimum packet size. |
| Packet Too Long Errors | The number of incoming packets with the length error to indicate that the packet size is bigger than the Ethernet maximum packet size. |
| Packets Discarded by Adapter | The number of incoming packets dropped by the hardware for any other reasons. |
| Receiver Start Count | The number of times that the receiver (receive unit) on the adapter is started. |
Receive Statistics Fields
| Field name | Description |
|---|---|
| Packets | The number of packets received successfully by the device. |
| Bytes | The number of bytes received successfully by the device. |
| Interrupts | The number of receive interrupts that are received by the driver from the adapter. |
| Receive Errors | The number of input errors that are encountered on the device. This is a counter for unsuccessful reception due to hardware/network errors. |
| Packets Dropped | The number of packets that are received by the device driver from this device that were not (for any reason) given to a network demuxer. |
| Bad Packets | The number of bad packets received (that is, saved) by the device driver. |
| Broadcast Packets | The number of broadcast packets that are received without any error. |
| Multicast Packets | The number of multicast packets that are received without any error. |
| CRC Errors | The number of incoming packets with the Checksum (FCS) error. |
| DMA Overrun | The number of incoming packets with the DMA overrun error. |
| Alignment Errors | The number of incoming packets with the alignment error. |
| No Resource Errors | The number of incoming packets dropped by the hardware due to the no resource error. |
| Receive Collision Errors | The number of incoming packets with the collision errors during the reception. |
| Packet Too Short Errors | The number of incoming packets with the length error to indicate that the packet size is less than the Ethernet minimum packet size. |
| Packet Too Long Errors | The number of incoming packets with the length error to indicate that the packet size is bigger than the Ethernet maximum packet size. |
| Packets Discarded by Adapter | The number of incoming packets dropped by the hardware for any other reasons. |
| Receiver Start Count | The number of times that the receiver (receive unit) on the adapter is started. |
General Statistics Fields
| Field name | Description |
|---|---|
| No mbuf Errors | The number of times that mbufs were not available to the device driver. This usually occurs during receive operations when the driver must obtain mbuf buffers to process inbound packets. If the mbuf pool for the requested size is empty, the packet is discarded. The netstat -m command can be used to confirm this. |
| Adapter Reset Count | The number of times that the adapter is restarted (re-initialized). |
| Adapter Data Rate | The maximum data rate of the adapter in Mbps (megabits per second). |
| Driver Flags | The device driver internal status flags that are currently turned on. |
Device Specific Statistics Fields
This part of the display might be different for each type of adapter. It might contain adapter-specific information and extended statistics that were not included in the general statistics. Some adapters might not have any device-specific statistics.
Note: Receive Address
Match Errors statistic of devices might increase, when the adapter
receives a unicast packet with a destination MAC address that does
not match the MAC address of the adapter. This scenario might
happen when an adapter is used by a Shared Ethernet Adapter to bridge
network traffic for client LPARs.
Examples
- To display the device generic statistics for ent0, type:
This produces output similar to the following:entstat ent0ETHERNET STATISTICS (ent0) : Device Type: Ethernet High Performance LAN Adapter Hardware Address: 02:60:8c:2e:d0:1d Elapsed Time: 0 days 0 hours 8 minutes 41 seconds Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 3 Packets: 2 Bytes: 272 Bytes: 146 Interrupts: 3 Interrupts: 2 Transmit Errors: 0 Receive Errors: 0 Packets Dropped: 0 Packets Dropped: 0 Max Packets on S/W Bad Packets: 0 Transmit Queue:0 S/W Transmit Queue Overflow: 0 Current S/W+H/W Transmit Queue Length: 0 Broadcast Packets: 2 CRC Errors: 0 Multicast Packets: 0 Broadcast Packets: 1 No Carrier Sense: 0 Multicast Packets: 0 DMA Underrun: 0 DMA Overrun: 0 Lost CTS Errors: 0 Alignment Errors: 0 Max Collision Errors: 0 No Resource Errors: 0 Late Collision Errors: 0 Receive Collision Errors: 0 Deferred: 0 Packet Too Short Errors: 0 SQE Test: 0 Packet Too Long Errors: 0 Timeout Errors: 0 Packets Discarded by Adapter: 0 Single Collision Receiver Start Count: 1 Count: 0 Multiple Collision Count: 0 Current HW Transmit Queue Length: 0 General Statistics: ------------------- No mbuf Errors: 0 Adapter Reset Count: 0 Driver Flags: Up Broadcast Running Simplex - To display the Ethernet device-generic statistics and the Ethernet device-specific statistics
for ent0, type:
Results similar to the following are displayed:entstat -all ent0ETHERNET STATISTICS (ent0) : Device Type: Ethernet High Performance LAN Adapter Hardware Address: 02:60:8c:2e:d0:1d Elapsed Time: 0 days 2 hours 6 minutes 30 seconds Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 3 Packets: 2 Bytes: 272 Bytes: 146 Interrupts: 3 Interrupts: 2 Transmit Errors: 0 Receive Errors: 0 Packets Dropped: 0 Packets Dropped: 0 Max Packets on S/W Receiver Start Count: 1 Transmit Queue:0 Bad Packets: 0 S/W Transmit Queue Overflow: 0 Current S/W+H/W Transmit Queue Length: 0 Broadcast Packets: 0 Broadcast Packets: 0 Multicast Packets: 0 Multicast Packets: 0 No Carrier Sense: 0 CRC Errors: 0 DMA Underrun: 0 DMA Overrun: 0 Lost CTS Errors: 0 Alignment Errors: 0 Max Collision Errors: 0 No Resource Errors: 0 Late Collision Errors: 0 Receive Collision Errors: 0 Deferred: 0 Packet Too Short Errors: 0 SQE Test: 0 Packet Too Long Errors: 0 Timeout Errors: 0 Packets Discarded by Adapter: 0 Single Collision Count: 0 Receiver Start Count: 1 Multiple Collision Count: 0 Current HW Transmit Queue Length: 0 General Statistics: ------------------- No mbuf Errors: 0 Adapter Reset Count: 0 Driver Flags: Up Broadcast Running Simplex Ethernet High Performance LAN Adapter Specific Statistics: ---------------------------------------------------------- Receive Buffer Pool Size: 37 Transmit Buffer Pool Size: 39 In Promiscuous Mode for IP Multicast: No Packets Uploaded from Adapter: 0 Host End-of-List Encountered: 0 82586 End-of-List Encountered: 0 Receive DMA Timeouts: 0 Adapter Internal Data: 0x0 0x0 0x0 0x0 0x0