Changeset View
Changeset View
Standalone View
Standalone View
sbin/ping/ping.8
Show All 35 Lines | |||||
.Nd send | .Nd send | ||||
.Tn ICMP | .Tn ICMP | ||||
or | or | ||||
.Tn ICMPv6 ECHO_REQUEST | .Tn ICMPv6 ECHO_REQUEST | ||||
packets to network hosts | packets to network hosts | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl 4AaDdfHnoQqRrv | .Op Fl 4AaDdfHnoQqRrv | ||||
.Op Fl .\& Ns Ar chars | |||||
.Op Fl C Ar pcp | .Op Fl C Ar pcp | ||||
.Op Fl c Ar count | .Op Fl c Ar count | ||||
.Op Fl G Ar sweepmaxsize | .Op Fl G Ar sweepmaxsize | ||||
.Op Fl g Ar sweepminsize | .Op Fl g Ar sweepminsize | ||||
.Op Fl h Ar sweepincrsize | .Op Fl h Ar sweepincrsize | ||||
.Op Fl i Ar wait | .Op Fl i Ar wait | ||||
.Op Fl l Ar preload | .Op Fl l Ar preload | ||||
.Op Fl M Cm mask | time | .Op Fl M Cm mask | time | ||||
.Op Fl m Ar ttl | .Op Fl m Ar ttl | ||||
.Op Fl P Ar policy | .Op Fl P Ar policy | ||||
.Op Fl p Ar pattern | .Op Fl p Ar pattern | ||||
.Op Fl S Ar src_addr | .Op Fl S Ar src_addr | ||||
.Op Fl s Ar packetsize | .Op Fl s Ar packetsize | ||||
.Op Fl t Ar timeout | .Op Fl t Ar timeout | ||||
.Op Fl W Ar waittime | .Op Fl W Ar waittime | ||||
.Op Fl z Ar tos | .Op Fl z Ar tos | ||||
.Ar IPv4-host | .Ar IPv4-host | ||||
.Nm | .Nm | ||||
.Op Fl 4AaDdfHLnoQqRrv | .Op Fl 4AaDdfHLnoQqRrv | ||||
.Op Fl .\& Ns Ar chars | |||||
.Op Fl C Ar pcp | .Op Fl C Ar pcp | ||||
.Op Fl c Ar count | .Op Fl c Ar count | ||||
.Op Fl I Ar iface | .Op Fl I Ar iface | ||||
.Op Fl i Ar wait | .Op Fl i Ar wait | ||||
.Op Fl l Ar preload | .Op Fl l Ar preload | ||||
.Op Fl M Cm mask | time | .Op Fl M Cm mask | time | ||||
.Op Fl m Ar ttl | .Op Fl m Ar ttl | ||||
.Op Fl P Ar policy | .Op Fl P Ar policy | ||||
.Op Fl p Ar pattern | .Op Fl p Ar pattern | ||||
.Op Fl S Ar src_addr | .Op Fl S Ar src_addr | ||||
.Op Fl s Ar packetsize | .Op Fl s Ar packetsize | ||||
.Op Fl T Ar ttl | .Op Fl T Ar ttl | ||||
.Op Fl t Ar timeout | .Op Fl t Ar timeout | ||||
.Op Fl W Ar waittime | .Op Fl W Ar waittime | ||||
.Op Fl z Ar tos | .Op Fl z Ar tos | ||||
.Ar IPv4-mcast-group | .Ar IPv4-mcast-group | ||||
.Nm | .Nm | ||||
.Op Fl 6AaDdEfHNnOoquvYyZ | .Op Fl 6AaDdEfHNnOoquvYyZ | ||||
.Op Fl .\& Ns Ar chars | |||||
.Op Fl b Ar bufsiz | .Op Fl b Ar bufsiz | ||||
.Op Fl c Ar count | .Op Fl c Ar count | ||||
.Op Fl e Ar gateway | .Op Fl e Ar gateway | ||||
.Op Fl I Ar interface | .Op Fl I Ar interface | ||||
.Op Fl i Ar wait | .Op Fl i Ar wait | ||||
.Op Fl k Ar addrtype | .Op Fl k Ar addrtype | ||||
.Op Fl l Ar preload | .Op Fl l Ar preload | ||||
.Op Fl m Ar hoplimit | .Op Fl m Ar hoplimit | ||||
▲ Show 20 Lines • Show All 51 Lines • ▼ Show 20 Lines | |||||
or | or | ||||
.Fl 6 | .Fl 6 | ||||
options, respectively. | options, respectively. | ||||
For backwards-compatibility, ICMPv6 can also be selected by invoking the binary | For backwards-compatibility, ICMPv6 can also be selected by invoking the binary | ||||
as | as | ||||
.Nm ping6 . | .Nm ping6 . | ||||
.Ss Options common to both IPv4 and IPv6 targets | .Ss Options common to both IPv4 and IPv6 targets | ||||
.Bl -tag -width indent | .Bl -tag -width indent | ||||
.It Fl .\& Ns Ar chars | |||||
By default, for every | |||||
.Tn ECHO_REQUEST | |||||
sent a period | |||||
rpokalaUnsubmitted Not Done Inline Actionsrpokala: ```
sent, a period
``` | |||||
.Dq .\& | |||||
is printed, while for every | |||||
.Tn ECHO_REPLY | |||||
received a backspace is printed. | |||||
rpokalaUnsubmitted Not Done Inline Actionsreceived, a backspace is printed. rpokala: ```
received, a backspace is printed.
``` | |||||
This option takes an optional string argument listing characters | |||||
that will be printed one by one in the provided order | |||||
instead of the default dot. | |||||
rpokalaUnsubmitted Not Done Inline ActionsYou call the default character period elsewhere, but you call it dot here. Pick one and use it consistently. (FWIW, I prefer dot.) rpokala: You call the default character `period` elsewhere, but you call it `dot` here. Pick one and use… | |||||
.Pp | |||||
Example usage: | |||||
.Bd -literal -offset indent | |||||
ping -.0123456789 freebsd.org | |||||
.Ed | |||||
.It Fl A | .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 | ||||
Show All 27 Lines | |||||
.It Fl d | .It Fl d | ||||
Set the | Set the | ||||
.Dv SO_DEBUG | .Dv SO_DEBUG | ||||
option on the socket being used. | option on the socket being used. | ||||
.It Fl f | .It Fl f | ||||
Flood ping. | Flood ping. | ||||
Outputs packets as fast as they come back or one hundred times per second, | Outputs packets as fast as they come back or one hundred times per second, | ||||
whichever is more. | whichever is more. | ||||
For every | Implies | ||||
.Fl .\& | |||||
to print a dot for every | |||||
.Tn ECHO_REQUEST | .Tn ECHO_REQUEST | ||||
sent a period | sent and a backspace for every | ||||
.Dq .\& | |||||
is printed, while for every | |||||
.Tn ECHO_REPLY | .Tn ECHO_REPLY | ||||
received a backspace is printed. | received. | ||||
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 H | .It Fl H | ||||
Hostname output. | Hostname output. | ||||
Try to do a reverse DNS lookup when displaying addresses. | Try to do a reverse DNS lookup when displaying addresses. | ||||
▲ Show 20 Lines • Show All 606 Lines • Show Last 20 Lines |