ping

Command Function

This command is used to test an IPv4 connection.

Syntax

ping [-4] [-c cnt] [-f] [-i interval] [-q] [-s size] <IP>

Parameters

Table 1 Parameter description

Parameter

Description

Value Range

--help

Displays the parameters supported by the ping command.

N/A

-4

Forcibly pings the destination address using the IPv4 protocol.

0-65500

-c CNT

Specifies the number of execution times. The default value is 3.

1-65535

-f

Pings an IPv4 address in implicit mode. The default parameter configuration is equivalent to -c 15 -i 0.2.

N/A

-i interval

Specifies the interval (in ms) for sending a ping packet.

1-200

-q

Implicitly pings an IPv4 address. If the host is active, the ping stops after true is received.

N/A

-s SIZE

Specifies the size of a ping packet, in bytes. The default size is 56 bytes.

0-4088

IP

Specifies the IPv4 address to test.

N/A

Usage

  • The ping command is used to check whether the destination IP address is reachable.
  • If the destination IP address is unreachable, the system displays a message indicating that the request times out.
  • If no route is available to the destination IP address, an error message is displayed.
  • This command can be used only after the TCP/IP stack is enabled.

Example

Run ping 192.168.1.3.

Output

Pinging a TFTP server IP address:

OHOS:/$ ping 192.168.1.3
Ping 192.168.1.3 (192.168.1.3): 56(84) bytes.
84 bytes from 192.168.1.3: icmp_seq=0 ttl=0 time=0 ms
84 bytes from 192.168.1.3: icmp_seq=0 ttl=0 time=1 ms
84 bytes from 192.168.1.3: icmp_seq=0 ttl=0 time=0 ms
--- 192.168.1.3 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss
round-trip min/avg/max = 0/0/0 ms