ping

Syntax

ping host <interface source-interface> <bypass-routing> <count requests> <do-not-fragment> <interval seconds> <pattern string> <record-route> <routing-instance routing-instance-name> <size bytes> <strict> <tos type-of-service> <ttl value> <via route> <rapid | detail>

Description

Check host reachability and network connectivity.

The ping command sends ICMP ECHO_REQUEST messages to elicit ICMP ECHO_RESPONSE messages from the specified host.

Type Ctrl-C to interrupt a ping command.

See Also

ping atm, ping mpls, and ping vpn-interface

Options

bypass-routing—(Optional) Bypass the normal routing tables and send ping requests directly to a system on an attached network. If the system is not on a directly attached network, an error is returned. Use this option to ping a local system through an interface that has no route through it.

count requests—(Optional) Number of ping requests to send.
Range: 0 through 1,000,000
Default: No limit to the number of requests sent. Type Ctrl-C to interrupt a ping command.

detail—(Optional) Include in the output the interface on which the ping reply was received.

do-not-fragment—(Optional) Set the do-not-fragment (DF) bit in the IP header of the ping packets.

host—IP address or name of the remote system to ping.

interface source-interface—(Optional) Interface to use to send the ping requests.

interval seconds—(Optional) How often to send ping requests.
Range: 0.1 through 10,000 seconds
Default: 1 second

pattern string—(Optional) Specify a 16-bit pattern string to include in the ping packet.
Range: 0 through 65536

routing-instance routing-instance-name—(Optional) Name of the routing instance for the ping attempt.

rapid—(Optional) Send ping requests rapidly. The results are reported in a single message, not in individual messages for each ping request. By default, five ping requests are sent before the results are reported. To change the number of request, include the count option.

record-route—(Optional) Record and report the packet's path.

size bytes—(Optional) Size of ping request packets.
Range: 0 through 65468 bytes
Default: 56 bytes, which is effectively 64 bytes because 8 bytes of ICMP header data are added to the packet.

strict—(Optional) Use strict source route option.

tos type-of-service—(Optional) Set the type-of-service (tos) bit in the IP header of the ping packets.
Range: 0 through 255

ttl value—(Optional) TTL value to include in the ping request.
Range: 0 through 255

via route—(Optional) Specify the intermediate router through which the packet should traverse on its way to the system being pinged. Configuring an intermediate router sets the loose source route field in the IP header.

Required Privilege Level

network

Sample Output

user@host> ping skye

PING skye.net (192.168.169.254): 56 data bytes

64 bytes from 192.168.169.254: icmp_seq=0 ttl=253 time=1.028 ms

64 bytes from 192.168.169.254: icmp_seq=1 ttl=253 time=1.053 ms

64 bytes from 192.168.169.254: icmp_seq=2 ttl=253 time=1.025 ms

64 bytes from 192.168.169.254: icmp_seq=3 ttl=253 time=1.098 ms

64 bytes from 192.168.169.254: icmp_seq=4 ttl=253 time=1.032 ms

64 bytes from 192.168.169.254: icmp_seq=5 ttl=253 time=1.044 ms

^C [abort]

user@host> ping skye size 200 count 5

PING skye.net (192.168.169.254): 200 data bytes

208 bytes from 192.168.169.254: icmp_seq=0 ttl=253 time=1.759 ms

208 bytes from 192.168.169.254: icmp_seq=1 ttl=253 time=2.075 ms

208 bytes from 192.168.169.254: icmp_seq=2 ttl=253 time=1.843 ms

208 bytes from 192.168.169.254: icmp_seq=3 ttl=253 time=1.803 ms

208 bytes from 192.168.169.254: icmp_seq=4 ttl=253 time=17.898 ms

--- skye.net ping statistics ---

5 packets transmitted, 5 packets received, 0% packet loss

round-trip min/avg/max = 1.759/5.075/17.898 ms

user@host> ping skye rapid

PING skye.net (192.168.169.254): 56 data bytes

!!!!!

--- skye.net ping statistics ---

5 packets transmitted, 5 packets received, 0% packet loss

round-trip min/avg/max/stddev = 0.956/0.974/1.025/0.026 ms