Ping
The PING function sends an ICMP ping to a given host to verify network reachability and responsiveness from the test device.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
HOST |
The host to ping — a hostname or IP address. | 8.8.8.8, google.com | Yes | |
TIMEOUT |
The maximum time to wait for a response, in seconds. | 5, 10, 30 | Yes | |
EXPECT |
The expected result of the ping. SUCCESS when the host responds, FAILURE when it should not. |
SUCCESS, FAILURE | Yes | SUCCESS |
Explanation of Fields¶
- HOST: The target host the device will ping (hostname or IP address).
- TIMEOUT: How long to wait for a reply before the step times out, in seconds.
- EXPECT: Defines the expected outcome —
SUCCESSif the host is reachable,FAILUREif it should be unreachable.