@PINGTIME
— Attempts to ping the
specified host.
Syntax:
%@PINGTIME[
hostname,
timeout,
packetsize,
ttl,
flags]
hostname | host name or dotted-quad IP address |
timeout | in seconds, 1 to 300 (60) |
packetsize | in bytes, 12 to 65520 (64) |
ttl | time-to-live, 1 to 255 |
flags | bitmapped: |
1 try IPv6 first, before IPv4 | |
2 compare reply data against sent data |
The hostname may be a user-defined macro
or one of the predefined macros: #ROUTER
, #DNS
, and so on.
On success, @PINGTIME
returns the response time in milliseconds. On error,
it returns a negative number:
-1 | request timed out |
-2 | host unreachable |
-3 | bad or unknown hostname |
-4 | other errors (out of memory?) |
-10 | data mismatch (only when bit 1 of flags is set) |
@PINGTIME
does not set any of the variables or
make a sound.