ping <host> interface <host> <option>
Specifies an interface that the device must use as the source address.
- 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.
- 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 device 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 ping 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.
Use the ping host interface command when pinging IPv6 link-local address.
When the ping command is interrupted by typing <Ctrl>+c, a brief statistical summary is displayed.
This example shows how to test whether an IPv4 interface is reachable.
vyatta@vyatta:~$ ping 192.1.2.2 interface dp0s6
PING 192.1.2.2 (192.1.2.2) from 192.1.2.1 dp0s6: 56(84) bytes of data.
64 bytes from 192.1.2.2: icmp_req=1 ttl=64 time=1.66 ms
^C
--- 192.1.2.2 ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 1.664/1.664/1.664/0.000 ms
This example shows how to test whether an IPv4 address is reachable using the specified interface address.
vyatta@vyatta:~$ ping 192.1.2.2 interface 192.1.2.1
PING 192.1.2.2 (192.1.2.2) from 192.1.2.1 : 56(84) bytes of data.
64 bytes from 192.1.2.2: icmp_req=1 ttl=64 time=1.02 ms
^C
This example shows how to test whether an IPv6 interface is reachable.
vyatta@vyatta:~$ ping 2012:dead::2 interface 2012:dead::1
PING 2012:dead::2(2012:dead::2) from 2012:dead::1 : 56 data bytes
64 bytes from 2012:dead::2: icmp_seq=1 ttl=64 time=3.04 ms
64 bytes from 2012:dead::2: icmp_seq=2 ttl=64 time=1.01 ms
^C
--- 2012:dead::2 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1001ms
rtt min/avg/max/mdev = 1.012/2.027/3.043/1.016 ms