show ipstats
Description
Displays IP statistics for the switch CPU or for a particular VLAN (Virtual LAN).
Syntax Description
name | Specifies a VLAN name. |
vrname | Specifies a VR or VRF. |
Default
N/A.
Usage Guidelines
This command only shows statistics of the CPU-handled packets. Not all packets are handled by the CPU.
If you do not specify a VR or VRF, the command applies to the current VR context.
The fields displayed in the show ipstats command are defined in the following tables.
Global IP Statistics Field Definitions
Field | Definition |
---|---|
InReceives | Total number of incoming IP packets processed by the CPU. |
InUnicast | Total number of unicast IP packets processed by the CPU. |
InBcast | Total number of broadcast IP packets processed by the CPU. |
InMcast | Total number of multicast IP packets processed by the CPU. |
InHdrEr | Total number of packets with an IP Header Error forwarded to the CPU. |
Bad vers | Total number of packets with a version other than IPv4 in the IP version field. |
Bad chksum | Total number of packets with a bad IP checksum forwarded to the CPU. |
Short pkt | IP packets that are too short. |
Short hdr | IP packets with a header that is too short. |
Bad hdrlen | IP packets with a header length that is less than the length specified. |
Bad length | IP packets with a length less than that of the header. |
InDelivers | IP packets passed to upper layer protocols. |
Bad Proto | IP packets with unknown (not standard) upper layer protocol. |
OutRequest | IP packets sent from upper layers to the IP stack. |
OutDiscard | IP packets that are discarded due to lack of buffer space or the router interface being down, or broadcast packets with broadcast forwarding disabled. |
OutNoRoute | IP packets with no route to the destination. |
Forwards | ForwardOK and Fwd Err aggregate count. |
ForwardOK | Total number of IP packets forwarded correctly. |
Fwd Err | Total number of IP packets that cannot be forwarded. |
NoFwding | Aggregate number of IP packets not forwarded due to errors. |
Redirects | IP packets forwarded on the same network. |
No route | Not used. |
Bad TTL | IP packets with a bad time-to-live. |
Bad MC TTL | IP packets with a bad multicast time-to-live. |
Bad IPdest | IP packets with an address that does not comply with the IPv4 standard. |
Blackhole | IP packets with a destination that is a blackhole entry. |
Output err | Not used. This is the same as Fwd Err. |
MartianSrc | IP packets with an invalid source address. |
Global ICMP Statistics Field Definitions
Field | Definition |
---|---|
OutResp | Echo replies sent from the CPU. |
OutError | Redirect from broadcast or multicast source addresses. |
InBadcode | Incoming ICMP (Internet Control Message Protocol) packets with an invalid CODE value. |
InTooshort | Incoming ICMP packets that are too short. |
Bad chksum | Incoming ICMP packets with checksum errors. |
In Badlen | Incoming ICMP packets with length errors. |
echo reply (In/Out): | ICMP “echo reply” packets that are received and transmitted. |
destination unreachable (In/Out): | ICMP packets with destination unreachable that are received and transmitted. |
port unreachable (In/Out): | ICMP packets with port unreachable that are received and transmitted. |
echo (In/Out): | ICMP echo packets that are received and transmitted. |
Global IGMP Statistics Field Definitions
Field | Definition |
---|---|
Out Query | Number of IGMP (Internet Group Management Protocol) query messages sent by the router. |
Out Report | Number of reports sent on an active multicast route interface for reserved multicast addresses and for regular IGMP reports forwarded by the query router. |
Out Leave | Number of IGMP out leave messages forwarded for IP multicast router interfaces. |
In Query | Number of IGMP query messages received. |
In Report | Number of IGMP report messages received (mostly from hosts). |
In Leave | Number of IGMP leave messages received (mostly from hosts). |
In Error | Number of IGMP packets with bad header fields or checksum failures. |
Router Interface Statistics Field Definitions
Field | Definition |
---|---|
Packets IN/OUT | Total number of IP packets received or transmitted on a VLAN router interface. |
Octets IN/OUT | Total number of octets received or transmitted on a VLAN router interface. |
Mcast packets IN/OUT | Total number of multicast packets received or transmitted on a VLAN router interface. |
Bcast packets IN/OUT | Total number of broadcast packets received or transmitted on a VLAN router interface. |
Errors IN/OUT | Total number of IP packets with errors received or transmitted on a VLAN router interface. |
Discards IN/OUT | Total number of IP packets that cannot travel up to the CPU due to lack of buffer space. |
Unknown Protocols IN/OUT | Total number of IP packets with unknown upper layer protocols received by the router interface. |
Example
The following example displays IP statistics for the VLAN "accounting":
show ipstats vlan accounting
History
This command was first available in ExtremeXOS 10.1.
The ipv4 keyword was added in ExtremeXOS 11.2.
Platform Availability
This command is available on the Summit X450-G2, X460-G2, X670-G2, X770, and ExtremeSwitching X440-G2, X620, X690, X870 series switches.