summaryrefslogtreecommitdiff
path: root/usr/src/man/man1m/ping.1m
diff options
context:
space:
mode:
authorYuri Pankov <yuri.pankov@nexenta.com>2011-10-03 04:36:40 -0700
committerYuri Pankov <yuri.pankov@nexenta.com>2011-10-03 04:36:40 -0700
commited22c7109fc5dd9e1b7a5d0333bdc7ad2718e2ab (patch)
tree3b2f488c4a03bda877119449bd63c01fa32aa6f2 /usr/src/man/man1m/ping.1m
parentaf8dc4373b25cce2c0bbb80f24e791f99eccbb6f (diff)
downloadillumos-joyent-ed22c7109fc5dd9e1b7a5d0333bdc7ad2718e2ab.tar.gz
1502 Remove conversion cruft from manpages
Reviewed by: Alexander Eremin <alexander.eremin@nexenta.com> Reviewed by: Gordon Ross <gordon.w.ross@gmail.com> Reviewed by: Garrett D'Amore <garrett.damore@gmail.com>
Diffstat (limited to 'usr/src/man/man1m/ping.1m')
-rw-r--r--usr/src/man/man1m/ping.1m64
1 files changed, 8 insertions, 56 deletions
diff --git a/usr/src/man/man1m/ping.1m b/usr/src/man/man1m/ping.1m
index e23c15ea62..6aa5ecc604 100644
--- a/usr/src/man/man1m/ping.1m
+++ b/usr/src/man/man1m/ping.1m
@@ -4,7 +4,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH ping 1M "7 Sep 2006" "SunOS 5.11" "System Administration Commands"
+.TH PING 1M "Sep 7, 2006"
.SH NAME
ping \- send ICMP (ICMP6) ECHO_REQUEST packets to network hosts
.SH SYNOPSIS
@@ -15,10 +15,10 @@ ping \- send ICMP (ICMP6) ECHO_REQUEST packets to network hosts
.LP
.nf
-\fB/usr/sbin/ping\fR \fB-s\fR [\fB-l\fR | \fB-U\fR] [\fB-abdlLnrRv\fR] [\fB-A\fR \fIaddr_family\fR]
- [\fB-c\fR \fItraffic_class\fR] [\fB-g\fR \fIgateway\fR [\fB-g\fR \fIgateway\fR...]]
- [\fB-N\fR \fInext_hop_router\fR] [\fB-F\fR \fIflow_label\fR] [\fB-I\fR \fIinterval\fR]
- [\fB-i\fR \fIinterface\fR] [\fB-P\fR \fItos\fR] [\fB-p\fR \fIport\fR] [\fB-t\fR \fIttl\fR] \fIhost\fR
+\fB/usr/sbin/ping\fR \fB-s\fR [\fB-l\fR | \fB-U\fR] [\fB-abdlLnrRv\fR] [\fB-A\fR \fIaddr_family\fR]
+ [\fB-c\fR \fItraffic_class\fR] [\fB-g\fR \fIgateway\fR [\fB-g\fR \fIgateway\fR...]]
+ [\fB-N\fR \fInext_hop_router\fR] [\fB-F\fR \fIflow_label\fR] [\fB-I\fR \fIinterval\fR]
+ [\fB-i\fR \fIinterface\fR] [\fB-P\fR \fItos\fR] [\fB-p\fR \fIport\fR] [\fB-t\fR \fIttl\fR] \fIhost\fR
[\fIdata_size\fR] [\fInpackets\fR]
.fi
@@ -73,12 +73,10 @@ verify that the local network interface is running.
The following options are supported:
.sp
.ne 2
-.mk
.na
\fB\fB-A\fR\ \fIaddr_family\fR\fR
.ad
.RS 24n
-.rt
Specify the address family of the target host. \fIaddr_family\fR can be either
\fBinet\fR or \fBinet6\fR. Address family determines which protocol to use. For
an argument of \fBinet\fR, IPv4 is used. For \fBinet6\fR, IPv6 is used.
@@ -101,24 +99,20 @@ host is unknown and exits.
.sp
.ne 2
-.mk
.na
\fB\fB-F\fR\ \fIflow_label\fR\fR
.ad
.RS 24n
-.rt
Specify the flow label of probe packets. The value must be an integer in the
range from 0 to 1048575. This option is valid only on IPv6.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-I\fR \fIinterval\fR\fR
.ad
.RS 24n
-.rt
Turn on the statistics mode and specify the interval between successive
transmissions. The default is one second. See the discussion of the \fB-s\fR
option.
@@ -126,12 +120,10 @@ option.
.sp
.ne 2
-.mk
.na
\fB\fB-L\fR\fR
.ad
.RS 24n
-.rt
Turn off loopback of multicast packets. Normally, members are in the host group
on the outgoing interface, a copy of the multicast packets will be delivered to
the local machine.
@@ -139,12 +131,10 @@ the local machine.
.sp
.ne 2
-.mk
.na
\fB\fB-N\fR \fInext_hop_router\fR\fR
.ad
.RS 24n
-.rt
Specify a next-hop router so that the probe packet goes through the specified
router along its path to the target host. This option essentially bypasses the
system routing table and leaves the probe packet header unmodified. Only one
@@ -153,12 +143,10 @@ next-hop router can be specified.
.sp
.ne 2
-.mk
.na
\fB\fB-P\fR\ \fItos\fR\fR
.ad
.RS 24n
-.rt
Set the type of service (\fItos\fR) in probe packets to the specified value.
The default is zero. The value must be an integer in the range from 0 to 255.
Gateways also in the path can route the probe packet differently, depending
@@ -168,12 +156,10 @@ valid only on IPv4.
.sp
.ne 2
-.mk
.na
\fB\fB-R\fR\fR
.ad
.RS 24n
-.rt
Record route. Sets the IPv4 record route option, which stores the route of the
packet inside the IPv4 header. The contents of the record route are only
printed if the \fB-v\fR and \fB-s\fR options are given. They are only set on
@@ -183,12 +169,10 @@ echos, or the \fB-l\fR option is given. This option is valid only on IPv4.
.sp
.ne 2
-.mk
.na
\fB\fB-U\fR\fR
.ad
.RS 24n
-.rt
Send \fBUDP\fR packets instead of \fBICMP\fR (\fBICMP6\fR) packets. \fBping\fR
sends \fBUDP\fR packets to consecutive ports expecting to receive back
\fBICMP\fR (\fBICMP6\fR) \fBPORT_UNREACHABLE\fR from the target host.
@@ -196,12 +180,10 @@ sends \fBUDP\fR packets to consecutive ports expecting to receive back
.sp
.ne 2
-.mk
.na
\fB\fB-a\fR\fR
.ad
.RS 24n
-.rt
\fBping\fR all addresses, both IPv4 and IPv6, of the multihomed destination.
The output appears as if \fBping\fR has been run once for each \fBIP\fR address
of the destination. If this option is used together with \fB-A\fR, \fBping\fR
@@ -214,12 +196,10 @@ to each \fBIP\fR address of the destination and then exits.
.sp
.ne 2
-.mk
.na
\fB\fB-b\fR\fR
.ad
.RS 24n
-.rt
Bypass the global IPsec policy and send and receive packets in the clear for
this connection only. This option can be used to troubleshoot network
connectivity independent of IPsec. Because this option bypasses system-wide
@@ -229,12 +209,10 @@ the sys_net_config privilege.
.sp
.ne 2
-.mk
.na
\fB\fB-c\fR\ \fItraffic_class\fR\fR
.ad
.RS 24n
-.rt
Specify the traffic class of probe packets. The value must be an integer in the
range from 0 to 255. Gateways along the path can route the probe packet
differently, depending upon the value of \fItraffic_class\fR set in the probe
@@ -243,23 +221,19 @@ packet. This option is valid only on IPv6.
.sp
.ne 2
-.mk
.na
\fB\fB-d\fR\fR
.ad
.RS 24n
-.rt
Set the \fBSO_DEBUG\fR socket option.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-g\fR\ \fIgateway\fR\fR
.ad
.RS 24n
-.rt
Specify a loose source route gateway so that the probe packet goes through the
specified host along the path to the target host. The maximum number of
gateways is 8 for IPv4 and 127 for IPv6. Note that some factors such as the
@@ -268,12 +242,10 @@ link \fBMTU\fR can further limit the number of gateways for IPv6.
.sp
.ne 2
-.mk
.na
\fB\fB-i\fR \fIinterface_address\fR\fR
.ad
.RS 24n
-.rt
Specify the outgoing interface address to use for multicast packets for IPv4
and both multicast and unicast packets for IPv6. The default interface address
for multicast packets is determined from the (unicast) routing tables.
@@ -284,12 +256,10 @@ interface index, for example \fB2\fR.
.sp
.ne 2
-.mk
.na
\fB\fB-l\fR\fR
.ad
.RS 24n
-.rt
Use to send the probe packet to the given host and back again using loose
source routing. Usually specified with the \fB-R\fR option. If any gateways are
specified using \fB-g\fR, they are visited twice, both to and from the
@@ -298,12 +268,10 @@ destination. This option is ignored if the \fB-U\fR option is used.
.sp
.ne 2
-.mk
.na
\fB\fB-n\fR\fR
.ad
.RS 24n
-.rt
Show network addresses as numbers. \fBping\fR normally does a reverse name
lookup on the IP addresses it extracts from the packets received. The \fB-n\fR
option blocks the reverse lookup, so \fBping\fR prints IP addresses instead of
@@ -312,12 +280,10 @@ host names.
.sp
.ne 2
-.mk
.na
\fB\fB-p\fR\ \fIport\fR\fR
.ad
.RS 24n
-.rt
Set the base \fBUDP\fR \fIport\fR number used in probes. This option is used
with the \fB-U\fR option. The default base \fIport\fR number is 33434. The
\fBping\fR utility starts setting the destination port number of \fBUDP\fR
@@ -326,12 +292,10 @@ packets to this base and increments it by one at each probe.
.sp
.ne 2
-.mk
.na
\fB\fB-r\fR\fR
.ad
.RS 24n
-.rt
Bypass the normal routing tables and send directly to a host on an attached
network. If the host is not on a directly attached network, an error is
returned. This option can be used to \fBping\fR a local host through an
@@ -340,23 +304,19 @@ interface that has been dropped by the router daemon. See \fBin.routed\fR(1M).
.sp
.ne 2
-.mk
.na
\fB\fB-s\fR\fR
.ad
.RS 24n
-.rt
Send one datagram per second and collect statistics.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-t\fR\ \fIttl\fR\fR
.ad
.RS 24n
-.rt
Specify the IPv4 time to live, or IPv6 hop limit, for unicast and multicast
packets. The default time to live (hop limit) for unicast packets can be set
with the \fBndd\fR module, \fB/dev/icmp\fR, using the \fBicmp_ipv4_ttl\fR
@@ -367,12 +327,10 @@ For further information, see\fBndd\fR(1M).
.sp
.ne 2
-.mk
.na
\fB\fB-v\fR\fR
.ad
.RS 24n
-.rt
Verbose output. List any \fBICMP\fR (\fBICMP6\fR) packets, other than replies
from the target host.
.RE
@@ -380,12 +338,10 @@ from the target host.
.SH OPERANDS
.sp
.ne 2
-.mk
.na
\fB\fIhost\fR\fR
.ad
.RS 8n
-.rt
The network host
.RE
@@ -409,9 +365,9 @@ PING xyz: 56 data bytes
64 bytes from xyz (fec0::114:a00:20ff:ab3d:83ed): icmp_seq=3. time=4.943 ms
64 bytes from xyz (4::114:a00:20ff:ab3d:83ed): icmp_seq=4. time=0.485 ms
64 bytes from xyz (fec0::114:a00:20ff:ab3d:83ed): icmp_seq=5. time=2.201 ms
-^C
-----xyz PING Statistics----
-6 packets transmitted, 6 packets received, 0% packet loss
+^C
+----xyz PING Statistics----
+6 packets transmitted, 6 packets received, 0% packet loss
round-trip (ms) min/avg/stddev = 0.479/1.583/4.943/1.823
.fi
.in -2
@@ -438,23 +394,19 @@ This example shows the \fBndd\fR module, \fB/dev/icmp\fR, used to set the
The following exit values are returned:
.sp
.ne 2
-.mk
.na
\fB\fB0\fR\fR
.ad
.RS 12n
-.rt
Successful operation; the machine is alive.
.RE
.sp
.ne 2
-.mk
.na
\fBnon-zero\fR
.ad
.RS 12n
-.rt
An error has occurred. Either a malformed argument has been specified, or the
machine was not alive.
.RE