cc/td/doc/product/aggr/vpn5000/5000sw/conc52x/ref52x
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

ping

ping

The ping command directs the device to send ICMP (Internet Control Message Protocol) Echo Request messages to an IP address. This command is often used to determine if a remote router or host is reachable.

ping {destination_address | host_name} [count count] [timeout timeout] [datalength data_length] [spray] [sourceaddress {source_address | {Ethernet | WAN} slot:port[.sub-interface]}]

Syntax Description

destination_address | host_name

This required parameter is used to indicate the host name or IP address of the ultimate destination. It can be entered either as a numerical IP address (e.g., 10.1.2.3) or a host name (e.g., hal.acme.com) if a Domain Name Server has been configured (see the Domain Name Server section).

count count

This optional keyword specifies the number of ICMP Echo Requests to be sent. The default is 1.

timeout timeout

This optional keyword specifies how long to wait in seconds for a reply from the remote host before timing out the request. The default is 2 seconds.

datalength data_length

This optional keyword specifies the data length of a packet. The default is 64 bytes.

spray

This optional keyword directs the ping command to output packets as fast as they come back or one every timeout period, whichever is first. For every Echo Request sent a "." is printed, and for every Echo Reply received it is erased.

sourceaddress {source_address | {Ethernet | WAN} slot:port[.sub-interface]}

This keyword specifies which port or address is to be used as the origin of the outbound packet. The value must be an IP address of an associated interface or a port name on the device. If no sourceaddress is specified, the device will, by default, use the address of the outbound interface as its source. This option allows packets that are sent out via ping to be correctly answered. This option allows the ping command to function over the Internet from a device which uses a private, unroutable WAN address. An example is the case where a Frame Relay link is using a private IP address on the WAN and the user wants to ping across that interface to test connectivity out to the Internet.

Usage Guidelines

When using the ping command to isolate network faults, hosts that are nearer to the device should be pinged first. Then, nodes successively further away should be probed. Round-trip times and packet loss statistics are computed. Duplicate and corrupted packets received from the remote node are flagged. Lost packets are flagged as timed out.

When the specified number of packets have been sent (and received), a brief summary is displayed. The command can also be terminated with a <CTRL-C>.

This command is intended to be used for network testing. Because of the network load imposed by the spray option, it is unwise to use ping during normal operation.

Examples

To send 10 echo packets to node 10.0.0.1 with a 1 second timeout:

Swizzle Router> ping 10.0.0.1 10 1

Packet len 64, seqnum 1 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 2 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 3 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 4 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 5 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 6 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 7 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 8 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 9 to [10.0.0.1] 0 ms. 
Packet len 64, seqnum 10 to [10.0.0.1] 0 ms. 
 
10 pings sent, 10 received (100%)
min/max/avg time in milliseconds = 0/0/0
Swizzle Router>
 

Note   If more processing is enabled, output will stop when a screenful of data has been output. If a lot of output is expected, more processing can be disabled using the set terminal nomore command.

Related Commands

Command Description

configure Domain Name Server

Configures a DNS for the concentrator

set terminal

Sets Terminal parameters


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Sep 27 11:39:24 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.