[Contents] [Prev] [Next] [Index] [Report an Error]

Using the ping Command

Use the CLI ping command to verify that a host can be reached over the network. This command is useful for diagnosing host and network connectivity problems. The Services Router sends a series of ICMP echo (ping) requests to a specified host and receives ICMP echo responses.

Alternatively, you can use the J-Web interface. (See Using the J-Web Ping Host Tool.)

Enter the ping command with the following syntax. Table 64 describes the ping command options.

user@host> ping host <interface source-interface> <bypass-routing> <count number>
<do-not-fragment> <inet>
<interval seconds>
<loose-source [ hosts ]>
<no-resolve> <pattern string>
<rapid> <record-route>
<routing-instance routing-instance-name>
<size bytes> <source address>
<strict> <strict-source [ hosts ]>
<tos number> <ttl number>
<verbose> <wait seconds>
<detail>

To quit the ping command, press Ctrl-C.

Table 64: CLI ping Command Options

Option	Description
host	Pings the hostname or IP address you specify.
interface source-interface	Sends the ping requests on the interface you specify. If you do not include this option, ping requests are sent on all interfaces.
bypass-routing	Bypasses the routing tables and send the ping requests only to hosts on directly attached interfaces. If the host is not on a directly attached interface, an error message is returned.
countnumber	Limits the number of ping requests to send. Specify a count from 0 through 1,000,000. If you do not specify a count, ping requests are continuously sent until you press Ctrl-C.
do-not-fragment	Sets the Don't Fragment (DF) bit in the IP header of the ping request packet.
inet	Forces the ping requests to an IPv4 destination.
interval seconds	Sets the interval between ping requests, in seconds. Specify an interval from 0.1 through 10,000. The default value is 1 second.
loose-source [ hosts ]	Sets the loose source routing option in the IP header of the ping request packet.
no-resolve	Suppresses the display of the hostnames of the hops along the path.
pattern string	Includes the hexadecimal string you specify, in the ping request packet.
rapid	Sends 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 requests, include the count option.
record-route	Sets the record route option in the IP header of the ping request packet. The path of the ping request packet is recorded within the packet and displayed on the screen.
routing-instance routing-instance-name	Uses the routing instance you specify for the ping request.
size bytes	Sets the size of the ping request packet. Specify a size from 0 through 65,468. The default value is 56 bytes, which is effectively 64 bytes because 8 bytes of ICMP header data are added to the packet.
source address	Uses the source address that you specify, in the ping request packet.
strict	Sets the strict source routing option in the IP header of the ping request packet.
strict-source [ hosts ]	Sets the strict source routing option in the IP header of the ping request packet, and uses the list of hosts you specify for routing the packet.
tos number	Sets the type-of-service (TOS) value in the IP header of the ping request packet. Specify a value from 0 through 255.
ttl number	Sets the time-to-live (TTL) value for the ping request packet. Specify a value from 0 through 255.
verbose	Displays detailed output.
wait seconds	Sets the maximum time to wait after sending the last ping request packet.
detail	Displays the interface on which the ping response was received.

Following is sample output from a ping command:

user@host> ping host3 count 4

PING host3.site.net (176.26.232.111): 56 data bytes
64 bytes from 176.26.232.111: icmp_seq=0 ttl=122 time=0.661 ms
64 bytes from 176.26.232.111: icmp_seq=1 ttl=122 time=0.619 ms
64 bytes from 176.26.232.111: icmp_seq=2 ttl=122 time=0.621 ms
64 bytes from 176.26.232.111: icmp_seq=3 ttl=122 time=0.634 ms

--- host3.site.net ping statistics ---
4 packets transmitted, 4 packets received, 0% packet loss
round-trip min/avg/max/stddev = 0.619/0.634/0.661/0.017 ms

The fields in the display are the same as those displayed by the J-Web ping host diagnostic tool. Table 58 summarizes these output fields.

[Contents] [Prev] [Next] [Index] [Report an Error]