|author||Ruslan Ermilov <ru@FreeBSD.org>||2004-05-17 08:25:15 +0000|
|committer||Ruslan Ermilov <ru@FreeBSD.org>||2004-05-17 08:25:15 +0000|
Reapply local changes that got simply axed by the latest KAME merge.
Fixed some more markup.
Notes: svn path=/head/; revision=129326
Diffstat (limited to 'sbin/ping6/ping6.8')
1 files changed, 42 insertions, 21 deletions
diff --git a/sbin/ping6/ping6.8 b/sbin/ping6/ping6.8
index 84a51edfb1f8..c2b24e41003a 100644
@@ -89,7 +89,7 @@ packets to network hosts
-command uses the
+utility uses the
@@ -106,7 +106,7 @@ The options are as follows:
.\" old ipsec
.\" .It Fl A
.\" Enables transport-mode IPsec authentication header
-.\" .Pq experimental .
.It Fl a Ar addrtype
Generate ICMPv6 Node Information Node Addresses query, rather than echo-request.
@@ -137,7 +137,7 @@ This is an experimental option.
Set socket buffer size.
.It Fl c Ar count
Stop after sending
-.Pq and receiving
@@ -147,7 +147,7 @@ Set the
option on the socket being used.
.\" .It Fl E
.\" Enables transport-mode IPsec encapsulated security payload
-.\" .Pq experimental .
.It Fl f
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.
-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.
asks the kernel to fragment packets to fit into the minimum IPv6 MTU.
will suppress the behavior in the following two levels:
when the option is specified once, the behavior will be disabled for
@@ -215,7 +217,7 @@ Probe node information multicast group
.Pq Li ff02::2:xxxx:xxxx .
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
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.
+.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.
This program is intended for use in network testing, measurement and
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 .
+.\" .Tn ICMP
.\" If the data space is at least eight bytes large,
@@ -340,12 +357,12 @@ during normal operations or from automated scripts.
.Sh DUPLICATE AND DAMAGED PACKETS
-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
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
-.Pq in the network or in the hosts .
+(in the network or in the hosts).
.Sh TRYING DIFFERENT DATA PATTERNS
@@ -385,10 +402,11 @@ You can then examine this file for repeated patterns that you can test
-.Nm Ns .
-.Sh RETURN VALUES
-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.
@@ -444,18 +462,21 @@ ping6 -a agl dst.foo.com
.Xr ping 8
-command appeared in
+utility appeared in
.Bx 4.3 .
-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.
-IPv6 and IPsec support based on the KAME Project (http://www.kame.net/) stack
-was initially integrated into
+IPv6 and IPsec support based on the KAME Project
+.Pq Pa http://www.kame.net/
+stack was initially integrated into
+.Fx 4.0 .
is intentionally separate from
.Xr ping 8 .