API Guide

number of ''pad'' bytes used to fill out the packet. A ping operation sends a packet to a specified IP
address and then measures the time that it takes to get a response from the address or device.
If the destination IP address is active, replies are sent back from the server including the IP address,
number of bytes sent, lapse time in milliseconds, and TTL, which is the number of hops back from the
source to the destination.
When you use the -I option and enter an IP address, OS10 considers it as the source address. If you use
an interface name instead of the IP address, OS10 considers it as the egress interface.
With the -I option, if you ping a reachable IP address using the IP address of a loopback interface as the
source interface, the ping succeeds. However, if you ping a reachable IP address using the name of the
loopback interface as the source interface, the ping fails. This is because the system considers the
loopback interface as the egress interface.
Example
OS10# ping 20.1.1.1
PING 20.1.1.1 (20.1.1.1) 56(84) bytes of data.
64 bytes from 20.1.1.1: icmp_seq=1 ttl=64 time=0.079 ms
64 bytes from 20.1.1.1: icmp_seq=2 ttl=64 time=0.081 ms
64 bytes from 20.1.1.1: icmp_seq=3 ttl=64 time=0.133 ms
64 bytes from 20.1.1.1: icmp_seq=4 ttl=64 time=0.124 ms
^C
--- 20.1.1.1 ping statistics ---
4 packets transmitted, 4 received, 0% packet loss, time 2997ms
rtt min/avg/max/mdev = 0.079/0.104/0.133/0.025 ms
Supported
Releases
10.2.0E or later
ping6
Tests network connectivity to an IPv6 device.
Syntax
ping6 [vrf {management | vrf-name}] [-aAbBdDfhLnOqrRUvV] [-c count] [-i
interval] [-I interface] [-l preload] [-m mark] [-M pmtudisc_option] [-N
nodeinfo_option] [-p pattern] [-Q tclass] [-s packetsize] [-S sndbuf] [-t
ttl] [-T timestamp_option] [-w deadline] [-W timeout] destination
Parameters
● vrf management — (Optional) Pings an IPv6 address in the management VRF instance.
● vrf vrf-name — (Optional) Pings an IPv6 address in a specified VRF instance.
● -a — (Optional) Audible ping.
● -A — (Optional) Adaptive ping. An inter-packet interval adapts to the round-trip time so that one (or
more, if you set the preload option) unanswered probe is present in the network. The minimum interval
is 200 msec for a non-super user, which corresponds to Flood mode on a network with a low round-
trip time.
● -b — (Optional) Pings a broadcast address.
● -B — (Optional) Does not allow ping to change the source address of probes. The source address is
bound to the address used when the ping starts.
● -c count — (Optional) Stops the ping after sending the specified number of ECHO_REQUEST
packets until the timeout expires.
● -d — (Optional) Sets the SO_DEBUG option on the socket being used.
● -D — (Optional) Prints the timestamp before each line.
● -F flowlabel — (Optional) Sets a 20-bit flow label on echo request packets. If value is zero, the
kernel allocates a random flow label.
● -h — (Optional) Displays help for this command.
● -i interval — (Optional) Enter the interval in seconds to wait between sending each packet, the
default is 1 second.
● -I interface-name or interface-ip-address — (Optional) Enter the source interface
name without spaces or the interface IP address:
CLI Basics 79