ping <host> audible <option>
Makes a beep sound when the router pings for the host details.
- 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.
- audible
- Makes a beep sound while the device pings for the host details.
- 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 the interface that the device must use as 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.
The host is specified either as host name (if DNS is being used on the network) or as an IPv4 or IPv6 address. If a host name is specified and neither the ipv4 nor ipv6 keyword is used, the IPv4 or IPv6 address associated with the host name is pinged, depending on which address is resolved first.
When using the ping command for fault isolation, enter the command on the local host to verify that the local network interface is up and running. Then, ping hosts and gateways farther away. Round-trip times and packet-loss statistics are computed.
If duplicate packets are received, they are not included in the packet-loss calculation, although the round-trip time of these packets is used in calculating the minimum, average, and maximum round-trip times.
When the ping command is interrupted by typing <Ctrl>+c, a brief statistical summary is displayed.
This example shows how to configure the router to send an ICMP_ECHO request five times, making a beep sound on every ping.
vyatta@vyatta:~$ ping www.google.com audible count 5
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=2 ttl=54 time=20.0 ms
From 10.18.170.201 icmp_seq=1 Destination Host Unreachable
From 10.18.170.201 icmp_seq=3 Destination Host Unreachable
64 bytes from sea15s02-in-f4.1e100.net (216.58.216.164): icmp_req=4 ttl=54 time=20.1 ms
--- www.google.com ping statistics ---
5 packets transmitted, 2 received, +2 errors, 60% packet loss, time 4010ms
rtt min/avg/max/mdev = 20.048/20.075/20.103/0.144 ms, pipe 3
vyatta@vyatta:~$