ping

This command determines whether the network can reach a remote target.

Syntax

ping remote-address [local-address]

ping remote-host [IP-version] [local-address]

Parameters

remote-address

Specifies the IP address of the target for the connection test.

remote-host

Specifies the hostname of the target for the connection test.

IP-version

Identifies the IP version to resolve an ambiguous hostname to an IP address. Ambiguity occurs when the DNS publishes an IPv4 address and an IPv6 address. If not specified, resolves to the preferred IP version as defined by the ip-preference command in DNS Settings mode.

-4: Identifies the target as an IPv4 host.
-6: Identifies the target as an IPv6 host.

This parameter applies to only ambiguous hostnames. Although you specify -6, the output shows the IPv4 address when the DNS published only an IPv4 address. Conversely, when you specify -4 and the DNS publishes only an IPv6 address, the output shows the IPv6 address.

local-address

Specifies the IP address or host alias of the local interface to use for the connection test.

Guidelines

The ping command determines whether the network can reach a remote target. When entered, 6 ICMP echo-request messages are sent to the specified host with a one-second interval between each message and reports the results.

Examples

Send 6 ICMP echo request to example.com with the preferred IP version.
```
ping example.com
```
Send 6 ICMP echo-request messages to example.com with its IPv4 address.
```
ping example.com -4
```
Send 6 ICMP echo-request messages from 1.2.3.4 to example.com with the preferred IP version.
```
ping example.com 1.2.3.4
```