From 44d907a2fc007702f8a71355e768a8717e6e466c Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Mon, 17 May 2004 08:25:15 +0000 Subject: [PATCH] Reapply local changes that got simply axed by the latest KAME merge. Fixed some more markup. --- sbin/ping6/ping6.8 | 63 ++++++++++++++++++++++++++++++---------------- 1 file changed, 42 insertions(+), 21 deletions(-) diff --git a/sbin/ping6/ping6.8 b/sbin/ping6/ping6.8 index 84a51edfb1f8..c2b24e41003a 100644 --- a/sbin/ping6/ping6.8 +++ b/sbin/ping6/ping6.8 @@ -89,7 +89,7 @@ packets to network hosts .Sh DESCRIPTION The .Nm -command uses the +utility uses the .Tn ICMPv6 protocol's mandatory .Tn ICMP6_ECHO_REQUEST @@ -106,7 +106,7 @@ The options are as follows: .\" old ipsec .\" .It Fl A .\" Enables transport-mode IPsec authentication header -.\" .Pq experimental . +.\" (experimental). .It Fl a Ar addrtype Generate ICMPv6 Node Information Node Addresses query, rather than echo-request. .Ar addrtype @@ -137,7 +137,7 @@ This is an experimental option. Set socket buffer size. .It Fl c Ar count Stop after sending -.Pq and receiving +(and receiving) .Ar count .Tn ECHO_RESPONSE packets. @@ -147,7 +147,7 @@ Set the option on the socket being used. .\" .It Fl E .\" Enables transport-mode IPsec encapsulated security payload -.\" .Pq experimental . +.\" (experimental). .It Fl f Flood ping. Outputs packets as fast as they come back or one hundred times per second, @@ -173,7 +173,7 @@ The gateway must be a neighbor of the sending node. Specifies to try reverse-lookup of IPv6 addresses. The .Nm -command 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 Set the IPv6 hoplimit. .It Fl I Ar interface @@ -201,7 +201,9 @@ Only the super-user may use this option. By default, .Nm asks the kernel to fragment packets to fit into the minimum IPv6 MTU. +The .Fl m +option will suppress the behavior in the following two levels: when the option is specified once, the behavior will be disabled for unicast packets. @@ -215,7 +217,7 @@ Probe node information multicast group .Pq Li ff02::2:xxxx:xxxx . .Ar host must be string hostname of the target -.Pq must not be a numeric IPv6 address . +(must not be a numeric IPv6 address). Node information multicast group will be computed based on given .Ar host , and will be used as the final destination. @@ -301,13 +303,26 @@ 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 round-trip time statistics. When the specified number of packets have been sent -.Pq and received +(and received) or if the program is terminated with a .Dv SIGINT , a brief summary is displayed, showing the number of packets sent and -received, and the minimum, maximum, mean, and standard deviation of +received, and the minimum, mean, maximum, and standard deviation of the round-trip times. .Pp +If +.Nm +receives a +.Dv SIGINFO +(see the +.Cm status +argument for +.Xr stty 1 ) +signal, the current number of packets sent and received, and the +minimum, mean, maximum, and standard deviation of the round-trip times +will be written to the standard output in the same format as the +standard completion message. +.Pp This program is intended for use in network testing, measurement and management. Because of the load it can impose on the network, it is unwise to use @@ -324,12 +339,14 @@ during normal operations or from automated scripts. .\" When a .\" .Ar packetsize .\" is given, this indicated the size of this extra piece of data -.\" .Pq the default is 56 . +.\" (the default is 56). .\" Thus the amount of data received inside of an IP packet of type .\" .Tn ICMP .\" .Tn ECHO_REPLY .\" will always be 8 bytes more than the requested data space -.\" .Pq the Tn ICMP header . +.\" (the +.\" .Tn ICMP +.\" header). .\" .Pp .\" If the data space is at least eight bytes large, .\" .Nm @@ -340,12 +357,12 @@ during normal operations or from automated scripts. .Sh DUPLICATE AND DAMAGED PACKETS The .Nm -command will report duplicate and damaged packets. +utility will report duplicate and damaged packets. Duplicate packets should never occur when pinging a unicast address, and seem to be caused by inappropriate link-level retransmissions. Duplicates may occur in many situations and are rarely -.Pq if ever +(if ever) a good sign, although the presence of low levels of duplicates may not always be cause for alarm. Duplicates are expected when pinging a broadcast or multicast address, @@ -356,7 +373,7 @@ Damaged packets are obviously serious cause for alarm and often indicate broken hardware somewhere in the .Nm packet's path -.Pq in the network or in the hosts . +(in the network or in the hosts). .Sh TRYING DIFFERENT DATA PATTERNS The (inter)network @@ -385,10 +402,11 @@ You can then examine this file for repeated patterns that you can test using the .Fl p option of -.Nm Ns . -.Sh RETURN VALUES +.Nm . +.Sh DIAGNOSTICS +The .Nm -command returns 0 on success (the host is alive), +utility returns 0 on success (the host is alive), and non-zero if the arguments are incorrect or the host is not responding. .Sh EXAMPLES Normally, @@ -444,18 +462,21 @@ ping6 -a agl dst.foo.com .Sh HISTORY The .Xr ping 8 -command appeared in +utility appeared in .Bx 4.3 . The .Nm -command with IPv6 support first appeared in the WIDE Hydrangea IPv6 +utility with IPv6 support first appeared in the WIDE Hydrangea IPv6 protocol stack kit. .Pp -IPv6 and IPsec support based on the KAME Project (http://www.kame.net/) stack -was initially integrated into -.Fx 4.0 +IPv6 and IPsec support based on the KAME Project +.Pq Pa http://www.kame.net/ +stack was initially integrated into +.Fx 4.0 . .Sh BUGS +The .Nm +utility is intentionally separate from .Xr ping 8 . .Pp