PREV NEXT INDEX

Avici Systems Inc.


ping


Tests network connectivity.

Syntax: ping [ip-addr|hostname] [internal] [num_packets] [packet_size] [timeout] [extended]

ip-addr

An IP address in dotted decimal notation.

hostname

The name of the host to which to send the test packets.

internal

Test the internal interfaces of the Avici router.

num_packets

The number of packets to send to the address as part of this test.

packet_size

The size of the packets to send to the address.

timeout

The number of seconds to wait for the remote system to respond.

extended

Test the connection to a specific source address using extended options.

Description: The ping command sends a packet to hostname or ipaddr and back to the requesting address. It reports whether the packet reached its destination to determine if the address you are pinging is actually alive.

Use the ping ip-addr | hostname syntax to send a packet to the specified IP address or host name.

Use the ping internal syntax to ping the internal interfaces of the system.

Use the ping extended syntax to send a ping using the extended options.

Use the ping <cr> syntax to interactively set the destination address and any other options. To accept the default value for an option, press <cr>. If you use this syntax, you will be prompted for the following information:

Hostname or IP Address:

Enter the host name or the IP address of a remote system.

Address family (0|1):

Type of address used by remote system. Valid values are:

0 - External IP address in dotted decimal format.

1 - Internal address of interfaces within the Avici router.

Default value = 0

Number of packets [5]:

Number of packets sent to remote address. Valid values are integers 1 - 65535.

Default value = 5

Size of packets [64]:

Number of bytes per packet. Valid values are integers 64 - 4096.

Default value = 64

Timeout in seconds [2]:

Number of seconds to wait for the remote system to respond before timeout. valid values are integers 1 - 255.

Default value = 2

Extended Options [n]:

Specifies whether the source address, Type of Service bit, Don't Fragment bit and Data pattern are to be configured.

Default value = n

Source Address:

Specifies the source address within the Avici router.

Type of Service [0]:

Specifies whether the Type of Service bit is set.

0 - Type of Service bit not set

1 - Type of Service bit set

Default value = 0xc0

Don't Fragment bit [0]:

Specifies whether the Don't Fragment bit is set.

0 - Don't Fragment bit not set

1 - Don't Fragment bit set

Default value = 0

Data Pattern

Specifies the data pattern in hexadecimal. Values may be up to 8 hexadecimal characters.

Factory Default: None.

Command Mode: Privileged.

Example 1: In the following example, the ping <cr> syntax interactively sends 5 packets to the host at IP address 10.5.1.221:

router#ping

Hostname or IP address: 10.5.0.1

Address family (0|1)[0]:

Number of packets [5]: 4

Size of packet [64]: 80

Timeout in seconds [2]: 12

Extended Options [n]: y

Source Address:

Type of Service [0]:

Don't Fragment bit [0]:

Data pattern [0xABCDABCD]:0xfa2c

Sending 5, 64 byte ICMP echoes to 10.5.0.1, timeout is 12 seconds:

36 bytes from 10.5.0.1: icmp_seq=0. time=0. ms

36 bytes from 10.5.0.1: icmp_seq=1. time=0. ms

36 bytes from 10.5.0.1: icmp_seq=2. time=0. ms

36 bytes from 10.5.0.1: icmp_seq=3. time=0. ms

100% success rate (4/4), round-trip min/avg/max = 0/0/0 ms>

Example 2: In the following example, the ping ip-address syntax sends an echo message to the specified remote system using the defaults:

router#ping 10.5.0.1

Sending 5, 64 byte ICMP echoes to 10.5.0.1, timeout is 2 seconds:

36 bytes from 10.5.0.1: icmp_seq=0. time=0. ms

36 bytes from 10.5.0.1: icmp_seq=1. time=0. ms

36 bytes from 10.5.0.1: icmp_seq=2. time=0. ms

36 bytes from 10.5.0.1: icmp_seq=3. time=0. ms

36 bytes from 10.5.0.1: icmp_seq=4. time=0. ms

100% success rate (5/5), round-trip min/avg/max = 0/0/0 ms

Example 3: In the following example, the ping ip-addr 1 syntax is used to send a single packet to remote address 10.5.5.1:

router>ping 10.5.5.1 1

10.5.5.1 is alive

Related Commands: None


PREV NEXT INDEX

Copyright © 2005 Avici Systems Inc.
Avici® and TSR® is a registered trademark of Avici Systems Inc.
IPriori™, Composite Links™, SSR™, QSR, and NSR® are trademarks of Avici Systems Inc.

   Source File Name: sys_mgmt.fm
    HTML File Name: sys_mgmt29.html
    Last Updated: 02/25/05 at 14:26:49

Please email suggestions and comments to: doc@avici.com