Ping (Compact 2013)
3/26/2014
The ping command-line tool verifies IP-level connectivity to another TCP/IP computer by sending Internet Control Message Protocol (ICMP) echo request messages. The ping command-line tool displays the receipt of corresponding echo reply messages, along with echo request/response round-trip times. It is the primary TCP/IP command that you use to troubleshoot connectivity, reachability, and name resolution. By default, ping sends both ICMP and ICMPv6 echo request messages. It also displays help when you use it without options.
Syntax
ping [-t] [-n count] [-l size] [-f] [-i TTL] [-v TOS] [-r count] [-s count] [-w timeout] [-S srcaddr] [-d] [-4 | -6] destination
Options
The following table describes each ping option. These options are not case-sensitive.
Option |
Option |
Description |
|---|---|---|
-t |
Sends echo requests to the specified destination until you stop the ping command-line tool. To stop the ping command-line tool, press CTRL+C. |
|
-n |
count |
Sends the number of ICMP echo request messages specified by count. The default is 4. |
-l |
size |
Specifies the length, in bytes, of the Data field in the echo request message. The size option specifies the number of bytes. The default is 32 bytes, and the maximum is 65,527 bytes. |
-f |
Specifies that ICMP echo request messages are sent with the Don’t Fragment flag in the IP packet header set to 1 (IPv4 only). When this flag is set, the echo request message cannot be fragmented by routers in the path to the destination. This option is useful for troubleshooting Path Maximum Transmission Unit (PMTU) problems. |
|
-i |
TTL |
Specifies the Time to Live value. This value is the maximum number of routers an IP packet may pass through before being discarded. The default is 32 routers. |
-v |
TOS |
Specifies the Type Of Service value (IPv4-only). The default is 0 (zero). For more about the TOS field in IPv4 packet headers, see RFC 1349. |
-r |
count |
Specifies that the Record Route option in the IP header is used to record the path taken by the echo request message and corresponding echo reply message (IPv4 only). Each hop in the path uses an entry in the Record Route option. The count option specifies the number of hops. If possible, specify a count value that is equal to or greater than the number of hops between the source and the destination. |
-s |
count |
Specifies that the Internet Timestamp option in the IP header is used to record the time of arrival for the echo request message and corresponding echo reply message for each hop (IPv4 only). The count option specifies the number of hops. |
-w |
timeout |
Specifies the amount of time, in milliseconds, to wait for the echo reply message that corresponds to a given echo request message. If the echo reply message is not received within the time-out, ping displays the "Request timed out" error message. The default time-out value is 4000 (4 seconds). |
-S |
srcaddr |
Specifies the source address to use (IPv6 only). |
-d |
Prints output to the debug output port. If your device is connected to Platform Builder, ping prints to the Output window in Visual Studio. |
|
-4 |
Specifies that IPv4 is used to ping the destination. This option is not necessary when you are identifying the destination with an IPv4 address; it is only necessary when you identify the target host by name. |
|
-6 |
Specifies that IPv6 is used to ping the destination. This option is not required when you are identifying the destination with an IPv6 address; it is only necessary when you identify the target host by name. |
|
destination |
Specifies the host name or IP address of the destination. |
Remarks
By default, ping queries both IPv4 and IPv6 addresses when you specify a host name for destination. You can override this behavior by using the -4 or -6 option.
Example
The following example shows typical output produced by the ping command-line tool.
\> ping 192.168.26.136
Pinging Host 192.168.26.136
Reply from 192.168.26.136: Echo size=32 time<1ms TTL=128
Reply from 192.168.26.136: Echo size=32 time<1ms TTL=128
See Also
Reference
Network Command-Line Tools Reference
Concepts
Network Command-Line Tools Catalog Items and Sysgen Variables