Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fix man page confusion about the -R option, per PR#4246

Browse Source 
Add some paragraph breaks for readability,
and a traceroute(8) reference.
This commit is contained in:
fair 1997-11-06 10:07:33 +00:00
parent 121b2869f7
commit 994948ff88
1 changed files with 23 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
sbin/ping/ping.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ping.8,v 1.18 1997/10/03 00:55:28 hubertf Exp $
.\" $NetBSD: ping.8,v 1.19 1997/11/06 10:07:33 fair Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -151,16 +151,6 @@ when finished.
.It Fl Q
Do not display responses such as Network Unreachable ICMP messages
concerning the ECHO_REQUESTs sent.
.It Fl R
Record route.
Includes the
.Tn RECORD_ROUTE
option in the
.Tn ECHO_REQUEST
packet and displays
the route buffer on returned packets.
Note that the IP header is only large enough for nine such routes.
Many hosts ignore or discard this option.
.It Fl r
Bypass the normal routing tables and send directly to a host on an attached
network.
@ -169,12 +159,18 @@ This option can be used to ping a local host through an interface
that has no route through it (e.g., after the interface was dropped by
.Xr routed 8 ) .
.It Fl R
Record Route. Includes the RECORD_ROUTE option in the ECHO_REQUEST
Record Route.
Includes the
.Tn RECORD_ROUTE
option in the
.Tn ECHO_REQUEST
packet and displays the route buffer on returned packets.
Note that the IP header is only large enough for eight such routes,
and only six when using the
.Fl g
option.
This is why it was necessary to invent
.Xr traceroute 8 .
Many hosts ignore or discard this option.
.It Fl s Ar packetsize
Specifies the number of data bytes to be sent.
@ -204,10 +200,12 @@ When using
for fault isolation, it should first be run on the local host, to verify
that the local network interface is up and running.
Then, hosts and gateways further and further away should be ``pinged''.
.Pp
Round-trip times and packet loss statistics are computed.
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 minimum/average/maximum round-trip time numbers.
.Pp
When the specified number of packets have been sent (and received) or
if the program is terminated with a
.Dv SIGINT ,
@ -228,7 +226,9 @@ output for every ECHO_RESPONSE returned. On a trusted system with IP
Security Options enabled, if the network idiom is not MONO,
.Nm
also prints a second line containing the hexadecimal representation
of the IP security option in the ECHO_RESPONSE. If the
of the IP security option in the ECHO_RESPONSE.
.Pp
If the
.Fl c
count option is given, only that number of requests is sent. No
output is produced if there is no response. Round-trip times and
@ -238,7 +238,9 @@ although the round trip time of these packets is used in calculating
the minimum/average/maximum round-trip time numbers. When the
specified number of packets have been sent (and received) or if
the program is terminated with an interrupt (SIGINT), a brief
summary is displayed. When not using the
summary is displayed.
.Pp
When not using the
.Fl f
(flood) option, the first interrupt, usually generated by control-C or DEL,
causes
@ -297,6 +299,7 @@ The (inter)network layer should never treat packets differently depending
on the data contained in the data portion.
Unfortunately, data-dependent problems have been known to sneak into
networks and remain undetected for long periods of time.
.Pp
In many cases the particular pattern that will have problems is something
that doesn't have sufficient ``transitions'', such as all ones or all
zeros, or a pattern right at the edge, such as almost all zeros.
@ -311,10 +314,9 @@ If you are lucky, you may manage to find a file that either can't be sent
across your network or that takes much longer to transfer than other
similar length files.
You can then examine this file for repeated patterns that you can test
using the
.Fl p
option of
.Nm "" .
using
.Nm
.Fl p .
.Sh TTL DETAILS
The
.Tn TTL
@ -404,8 +406,9 @@ broadcast address should only be done under very controlled conditions.
.Sh SEE ALSO
.Xr netstat 1 ,
.Xr ifconfig 8 ,
.Xr spray 8 ,
.Xr routed 8
.Xr routed 8 ,
.Xr traceroute 8 ,
.Xr spray 8
.Sh HISTORY
The
.Nm