ping <host> deadline <seconds> <option>
Specifies the number of seconds before which the ping expires.
- ipv4_address
- The IPv4 address of the host.
- ipv6_address
- The IPv6 address of the host.
- hostname
- A host being pinged. This keyword is used when the host is specified as a host name rather than as an IP address.
- seconds
- The number of seconds before which ping exits.
- option
- Each of the following entries are considered options. These options can be issued consecutively, that is, in the same command line.
- adaptive
- Adaptively sets interpacket interval.
- allow-broadcast
- Allows you to ping broadcast address.
- audible
- Makes a beep sound on every ping, while the router pings for host details.
- bypass-route
- Bypasses normal routing tables during ping.
- count
- Specifies the number of ping requests to send.
- deadline
- Specifies the number of seconds before which ping expires.
- ether-size
- Matches the overall size of the data packet with the resultant size of the Layer 3 packet.
- flood
- Sends 100 ping requests each second.
- interface
- Specifies an interface that the device must use as the source address.
- interval
- Specifies the time in seconds for which the device must wait between ping requests.
- mark
- Specifies that the device must consider the request for special processing.
- mtu-discovery
- Specifies the path MTU discovery strategy.
- no-loopback
- Suppresses loop-back of multicast pings.
- numeric
- Does not resolve domain name system (DNS) names during ping.
- pattern
- Specifies the hexadecimal digit pattern to fill the packet.
- quiet
- Prints only the ping summary page.
- record-route
- Records the route that the packet takes.
- size
- Specifies the number of bytes to send for a ping request.
- timestamp
- Displays the timestamp during ping output.
- tos
- Marks packet with specified type of service (TOS).
- ttl
- Specifies the maximum packet life-time for a host.
- verbose
- Displays a detailed output for the ping command.
Operational mode
The ping command tests whether a network host is reachable.
The ping command uses the ECHO_REQUEST datagram (ping) of the ICMP protocol to get an ICMP ECHO_RESPONSE from a host or gateway. ECHO_REQUEST datagrams have an IP and an ICMP header, followed by a struct timeval data type and then an arbitrary number of pad bytes that are used to fill the packet.
When the ping command is interrupted by typing <Ctrl>+c , a brief statistical summary is displayed.
This example shows how to test whether www.google.com network is reachable within three seconds.
vyatta@vyatta:~$ ping www.google.com deadline 3
PING www.google.com (216.58.216.164) 56(84) bytes of data.
64 bytes from sea15s02-in-f4.1e100.net (216.58.216.164): icmp_req=1 ttl=54 time=19.8 ms
64 bytes from sea15s02-in-f4.1e100.net (216.58.216.164): icmp_req=3 ttl=54 time=20.1 ms
--- www.google.com ping statistics ---
3 packets transmitted, 2 received, 33% packet loss, time 2004ms
rtt min/avg/max/mdev = 19.873/19.995/20.118/0.187 ms