ping

ping {count count {start-size start-size} | continuous {start-size start-size} | {start-size start-size {end-size end-size}}} {udp} {dont-fragment} {ttl ttl} {tos tos} {interval interval} {vr vrid} {ipv4 host | ipv6 host} {from} {with record-route}

Description

Enables you to send User Datagram Protocol (UDP) or Internet Control Message Protocol (ICMP) echo messages or to a remote IP device.

Syntax Description

count Specifies the number of ping requests to send.
start-size Specifies the size, in bytes, of the packet to be sent, or the starting size if incremental packets are to be sent.
continuous Specifies that UDP or ICMP echo messages to be sent continuously. This option can be interrupted by pressing [Ctrl} + C.
end-size Specifies an end size for packets to be sent.
udp Specifies that the ping request should use UDP instead of ICMP.
dont-fragment Sets the IP to not fragment the bit.
ttl Sets the TTL value.
tos Sets the TOS value.
interval Sets the time interval between sending out ping requests.
vr Specifies the virtual route to use for sending out the echo message. If not specified, VR-Default is used.
Note: User-created VRs are supported only on the platforms listed for this feature in the Feature License Requirements document.
ipv4 Specifies IPv4 transport.
ipv6 Specifies IPv6 transport.
Note: If you are contacting an IPv6 link local address, you must specify the VLAN you are sending the message from: ping ipv6 link-local address %vlan_name host .
host Specifies a host name or IP address (either v4 or v6).
from Uses the specified source address. If not specified, the address of the transmitting interface is used.
with record-route Sets the traceroute information.

Default

N/A.

Usage Guidelines

The ping command is used to test for connectivity to a specific host.

You use the ipv6 variable to ping an IPv6 host by generating an ICMPv6 echo request message and sending the message to the specified address. If you are contacting an IPv6 link local address, you must specify the VLAN you are sending the message from, as shown in the following example (you must include the % sign):

ping ipv6 link-local address %vlan_name host.

The ping command is available for both the user and administrator privilege level.

When the IPv6 host ping fails, the following error message displays:

Error: cannot determine outgoing interface. Link local address must be of form LLA%vlan_name. 

If you have an asymmetric routing to a specific destination (where the traffic from the source to the destination uses one path, and the return traffic uses another), use this command with option 7, with record-route.

For example:

ping <destination address> with record-route
ping <destination address> from <source-address> with record-route

For more information about this option, see enable ip-option record-route.

Example

The following example enables continuous ICMP echo messages to be sent to a remote host:

ping continuous 123.45.67.8

The following example uses the with record-route option:

ping 10.2.1.1 from 10.2.1.2 with record-route
Ping(ICMP) 10.2.1.1: 4 packets, 8 data bytes, interval 1 second(s).
16 bytes from 10.2.1.1: icmp_seq=0 ttl=63 time=10 ms
RR: 10.2.1.2    10.2.0.21    10.2.1.1    10.2.1.1    10.2.0.1    10.2.1.2  

History

This command was first available in ExtremeXOS 10.1.

The ipv6 option was added in ExtremeXOS 11.2.

The IPv6 error message was modified in ExtremeXOS 15.2.

Platform Availability

This command is available on all platforms.