Changeset View
Changeset View
Standalone View
Standalone View
head/sbin/ping6/ping6.8
Show All 23 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd September 22, 2014 | .Dd August 22, 2019 | ||||
.Dt PING6 8 | .Dt PING6 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ping6 | .Nm ping6 | ||||
.Nd send | .Nd send | ||||
.Tn ICMPv6 ECHO_REQUEST | .Tn ICMPv6 ECHO_REQUEST | ||||
packets to network hosts | packets to network hosts | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.\" without ipsec, or new ipsec | .\" without ipsec, or new ipsec | ||||
.Op Fl DdfHmnNoqrRtvwW | .Op Fl aAdDfHnNoOquvyY | ||||
.\" old ipsec | .\" old ipsec | ||||
.\" .Op Fl ADdEfmnNqRtvwW | .\" .Op Fl ADdEfmnNqRtvwW | ||||
.Bk -words | .Bk -words | ||||
.Op Fl a Ar addrtype | |||||
.Ek | |||||
.Bk -words | |||||
.Op Fl b Ar bufsiz | .Op Fl b Ar bufsiz | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl c Ar count | .Op Fl c Ar count | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl g Ar gateway | .Op Fl e Ar gateway | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl h Ar hoplimit | |||||
.Ek | |||||
.Bk -words | |||||
.Op Fl I Ar interface | .Op Fl I Ar interface | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl i Ar wait | .Op Fl i Ar wait | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl x Ar waittime | .Op Fl k Ar addrtype | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl X Ar timeout | .Op Fl l Ar preload | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl l Ar preload | .Op Fl m Ar hoplimit | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.\" new ipsec | .\" new ipsec | ||||
.Op Fl P Ar policy | .Op Fl P Ar policy | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl p Ar pattern | .Op Fl p Ar pattern | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl S Ar sourceaddr | .Op Fl S Ar sourceaddr | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl s Ar packetsize | .Op Fl s Ar packetsize | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Op Fl t Ar timeout | |||||
.Ek | |||||
.Bk -words | |||||
.Op Fl W Ar waittime | |||||
.Ek | |||||
.Bk -words | |||||
.Op Ar hops ... | .Op Ar hops ... | ||||
.Ek | .Ek | ||||
.Bk -words | .Bk -words | ||||
.Ar host | .Ar host | ||||
.Ek | .Ek | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
utility uses the | utility uses the | ||||
.Tn ICMPv6 | .Tn ICMPv6 | ||||
protocol's mandatory | protocol's mandatory | ||||
.Tn ICMP6_ECHO_REQUEST | .Tn ICMP6_ECHO_REQUEST | ||||
datagram to elicit an | datagram to elicit an | ||||
.Tn ICMP6_ECHO_REPLY | .Tn ICMP6_ECHO_REPLY | ||||
from a host or gateway. | from a host or gateway. | ||||
.Tn ICMP6_ECHO_REQUEST | .Tn ICMP6_ECHO_REQUEST | ||||
datagrams (``pings'') have an IPv6 header, | datagrams (``pings'') have an IPv6 header, | ||||
and | and | ||||
.Tn ICMPv6 | .Tn ICMPv6 | ||||
header formatted as documented in RFC2463. | header formatted as documented in RFC2463. | ||||
The options are as follows: | The options are as follows: | ||||
.Bl -tag -width Ds | .Bl -tag -width Ds | ||||
.\" old ipsec | .\" old ipsec | ||||
.\" .It Fl A | .\" .It Fl Z | ||||
.\" Enables transport-mode IPsec authentication header | .\" Enables transport-mode IPsec authentication header | ||||
.\" (experimental). | .\" (experimental). | ||||
.It Fl a Ar addrtype | .It Fl k Ar addrtype | ||||
Generate ICMPv6 Node Information Node Addresses query, rather than echo-request. | Generate ICMPv6 Node Information Node Addresses query, rather than echo-request. | ||||
.Ar addrtype | .Ar addrtype | ||||
must be a string constructed of the following characters. | must be a string constructed of the following characters. | ||||
.Bl -tag -width Ds -compact | .Bl -tag -width Ds -compact | ||||
.It Ic a | .It Ic a | ||||
requests unicast addresses from all of the responder's interfaces. | requests unicast addresses from all of the responder's interfaces. | ||||
If the character is omitted, | If the character is omitted, | ||||
only those addresses which belong to the interface which has the | only those addresses which belong to the interface which has the | ||||
▲ Show 20 Lines • Show All 42 Lines • ▼ Show 20 Lines | |||||
is printed, while for every | is printed, while for every | ||||
.Tn ECHO_REPLY | .Tn ECHO_REPLY | ||||
received a backspace is printed. | received a backspace is printed. | ||||
This provides a rapid display of how many packets are being dropped. | This provides a rapid display of how many packets are being dropped. | ||||
Only the super-user may use this option. | Only the super-user may use this option. | ||||
.Bf -emphasis | .Bf -emphasis | ||||
This can be very hard on a network and should be used with caution. | This can be very hard on a network and should be used with caution. | ||||
.Ef | .Ef | ||||
.It Fl g Ar gateway | .It Fl e Ar gateway | ||||
Specifies to use | Specifies to use | ||||
.Ar gateway | .Ar gateway | ||||
as the next hop to the destination. | as the next hop to the destination. | ||||
The gateway must be a neighbor of the sending node. | The gateway must be a neighbor of the sending node. | ||||
.It Fl H | .It Fl H | ||||
Specifies to try reverse-lookup of IPv6 addresses. | Specifies to try reverse-lookup of IPv6 addresses. | ||||
The | The | ||||
.Nm | .Nm | ||||
utility does not try reverse-lookup unless the option is specified. | utility does not try reverse-lookup unless the option is specified. | ||||
.It Fl h Ar hoplimit | .It Fl m Ar hoplimit | ||||
Set the IPv6 hoplimit. | Set the IPv6 hoplimit. | ||||
.It Fl I Ar interface | .It Fl I Ar interface | ||||
Source packets with the given interface address. | Source packets with the given interface address. | ||||
This flag applies if the ping destination is a multicast address, | This flag applies if the ping destination is a multicast address, | ||||
or link-local/site-local unicast address. | or link-local/site-local unicast address. | ||||
.It Fl i Ar wait | .It Fl i Ar wait | ||||
Wait | Wait | ||||
.Ar wait | .Ar wait | ||||
seconds | seconds | ||||
.Em between sending each packet . | .Em between sending each packet . | ||||
The default is to wait for one second between each packet. | The default is to wait for one second between each packet. | ||||
This option is incompatible with the | This option is incompatible with the | ||||
.Fl f | .Fl f | ||||
option. | option. | ||||
.It Fl x Ar waittime | .It Fl W Ar waittime | ||||
Time in milliseconds to wait for a reply for each packet sent. | Time in milliseconds to wait for a reply for each packet sent. | ||||
If a reply arrives later, | If a reply arrives later, | ||||
the packet is not printed as replied, | the packet is not printed as replied, | ||||
but considered as replied when calculating statistics. | but considered as replied when calculating statistics. | ||||
.It Fl X Ar timeout | .It Fl t Ar timeout | ||||
Specify a timeout, | Specify a timeout, | ||||
in seconds, | in seconds, | ||||
before ping exits regardless of how many packets have been received. | before ping exits regardless of how many packets have been received. | ||||
.It Fl l Ar preload | .It Fl l Ar preload | ||||
If | If | ||||
.Ar preload | .Ar preload | ||||
is specified, | is specified, | ||||
.Nm | .Nm | ||||
sends that many packets as fast as possible before falling into its normal | sends that many packets as fast as possible before falling into its normal | ||||
mode of behavior. | mode of behavior. | ||||
Only the super-user may use this option. | Only the super-user may use this option. | ||||
.It Fl m | .It Fl u | ||||
By default, | By default, | ||||
.Nm | .Nm | ||||
asks the kernel to fragment packets to fit into the minimum IPv6 MTU. | asks the kernel to fragment packets to fit into the minimum IPv6 MTU. | ||||
The | The | ||||
.Fl m | .Fl u | ||||
option | option | ||||
will suppress the behavior in the following two levels: | will suppress the behavior in the following two levels: | ||||
when the option is specified once, the behavior will be disabled for | when the option is specified once, the behavior will be disabled for | ||||
unicast packets. | unicast packets. | ||||
When the option is more than once, it will be disabled for both | When the option is more than once, it will be disabled for both | ||||
unicast and multicast packets. | unicast and multicast packets. | ||||
.It Fl n | .It Fl n | ||||
Numeric output only. | Numeric output only. | ||||
Show All 34 Lines | |||||
.\" new ipsec | .\" new ipsec | ||||
.It Fl P Ar policy | .It Fl P Ar policy | ||||
.Ar policy | .Ar policy | ||||
specifies IPsec policy to be used for the probe. | specifies IPsec policy to be used for the probe. | ||||
.It Fl q | .It Fl q | ||||
Quiet output. | Quiet output. | ||||
Nothing is displayed except the summary lines at startup time and | Nothing is displayed except the summary lines at startup time and | ||||
when finished. | when finished. | ||||
.It Fl r | .It Fl a | ||||
Audible. | Audible. | ||||
Include a bell | Include a bell | ||||
.Tn ( ASCII | .Tn ( ASCII | ||||
0x07) | 0x07) | ||||
character in the output when any packet is received. | character in the output when any packet is received. | ||||
.It Fl R | .It Fl A | ||||
Audible. | Audible. | ||||
Output a bell | Output a bell | ||||
.Tn ( ASCII | .Tn ( ASCII | ||||
0x07) | 0x07) | ||||
character when no packet is received before the next packet | character when no packet is received before the next packet | ||||
is transmitted. | is transmitted. | ||||
To cater for round-trip times that are longer than the interval | To cater for round-trip times that are longer than the interval | ||||
between transmissions, further missing packets cause a bell only | between transmissions, further missing packets cause a bell only | ||||
if the maximum number of unreceived packets has increased. | if the maximum number of unreceived packets has increased. | ||||
.It Fl S Ar sourceaddr | .It Fl S Ar sourceaddr | ||||
Specifies the source address of request packets. | Specifies the source address of request packets. | ||||
The source address must be one of the unicast addresses of the sending node, | The source address must be one of the unicast addresses of the sending node, | ||||
and must be numeric. | and must be numeric. | ||||
.It Fl s Ar packetsize | .It Fl s Ar packetsize | ||||
Specifies the number of data bytes to be sent. | Specifies the number of data bytes to be sent. | ||||
The default is 56, which translates into 64 | The default is 56, which translates into 64 | ||||
.Tn ICMP | .Tn ICMP | ||||
data bytes when combined | data bytes when combined | ||||
with the 8 bytes of | with the 8 bytes of | ||||
.Tn ICMP | .Tn ICMP | ||||
header data. | header data. | ||||
You may need to specify | You may need to specify | ||||
.Fl b | .Fl b | ||||
as well to extend socket buffer size. | as well to extend socket buffer size. | ||||
.It Fl t | .It Fl O | ||||
Generate ICMPv6 Node Information supported query types query, | Generate ICMPv6 Node Information supported query types query, | ||||
rather than echo-request. | rather than echo-request. | ||||
.Fl s | .Fl s | ||||
has no effect if | has no effect if | ||||
.Fl t | .Fl O | ||||
is specified. | is specified. | ||||
.It Fl v | .It Fl v | ||||
Verbose output. | Verbose output. | ||||
.Tn ICMP | .Tn ICMP | ||||
packets other than | packets other than | ||||
.Tn ECHO_RESPONSE | .Tn ECHO_RESPONSE | ||||
that are received are listed. | that are received are listed. | ||||
.It Fl w | .It Fl y | ||||
Generate ICMPv6 Node Information DNS Name query, rather than echo-request. | Generate ICMPv6 Node Information DNS Name query, rather than echo-request. | ||||
.Fl s | .Fl s | ||||
has no effect if | has no effect if | ||||
.Fl w | .Fl y | ||||
is specified. | is specified. | ||||
.It Fl W | .It Fl Y | ||||
Same as | Same as | ||||
.Fl w , | .Fl y , | ||||
but with old packet format based on 03 draft. | but with old packet format based on 03 draft. | ||||
This option is present for backward compatibility. | This option is present for backward compatibility. | ||||
.Fl s | .Fl s | ||||
has no effect if | has no effect if | ||||
.Fl w | .Fl y | ||||
is specified. | is specified. | ||||
.It Ar hops | .It Ar hops | ||||
IPv6 addresses for intermediate nodes, | IPv6 addresses for intermediate nodes, | ||||
which will be put into type 0 routing header. | which will be put into type 0 routing header. | ||||
.It Ar host | .It Ar host | ||||
IPv6 address of the final destination node. | IPv6 address of the final destination node. | ||||
.El | .El | ||||
.Pp | .Pp | ||||
▲ Show 20 Lines • Show All 218 Lines • Show Last 20 Lines |