diff --git a/doc/fping.pod b/doc/fping.pod index 30fd956..9761f38 100644 --- a/doc/fping.pod +++ b/doc/fping.pod @@ -4,7 +4,7 @@ fping - send ICMP ECHO_REQUEST packets to network hosts =head1 SYNOPSIS -B [ I ] [ I ] +B [ I ] [ I ] =head1 DESCRIPTION @@ -35,7 +35,7 @@ Restrict name resolution and IPs to IPv6 addresses. =item B<-a>, B<--alive> -Show systems that are alive. +Show systems that are alive. =item B<-A>, B<--addr> @@ -50,7 +50,7 @@ timestamp). The reported received data size includes the IP header (normally 20 bytes) and ICMP header (8 bytes), so the minimum total size is 40 bytes. Default is 56, as in B. Maximum is the theoretical maximum IP datagram size (64K), though most systems limit this to a smaller, system-dependent -number. +number. =item B<-B>, B<--backoff>=I @@ -58,25 +58,25 @@ Backoff factor. In the default mode, B sends several requests to a target before giving up, waiting longer for a reply on each successive request. This parameter is the value by which the wait time (B<-t>) is multiplied on each successive request; it must be entered as a floating-point number (x.y). The -default is 1.5. +default is 1.5. =item B<-c>, B<--count>=I Number of request packets to send to each target. In this mode, a line is displayed for each received response (this can suppressed with B<-q> or B<-Q>). Also, statistics about responses for each target are displayed when all -requests have been sent (or when interrupted). +requests have been sent (or when interrupted). =item B<-C>, B<--vcount>=I Similar to B<-c>, but the per-target statistics are displayed in a format -designed for automated response-time statistics gathering. For example: +designed for automated response-time statistics gathering. For example: - % fping -C 5 -q somehost - somehost : 91.7 37.0 29.2 - 36.8 + $ fping -C 5 -q somehost + somehost : 91.7 37.0 29.2 - 36.8 shows the response time in milliseconds for each of the five requests, with the -C<-> indicating that no response was received to the fourth request. +C<-> indicating that no response was received to the fourth request. =item B<-d>, B<--rdns> @@ -92,14 +92,14 @@ modes (B<-l>, B<-c>, or B<-C>). =item B<-e>, B<--elapsed> -Show elapsed (round-trip) time of packets. +Show elapsed (round-trip) time of packets. =item B<-f>, B<--file> Read list of targets from a file. This option can only be used by the root -user. Regular users should pipe in the file via stdin: +user. Regular users should pipe in the file via stdin: - % fping < targets_file + $ fping < targets_file =item B<-g>, B<--generate> I @@ -109,25 +109,33 @@ a network with netmask is given, the network and broadcast addresses will be excluded. ex. To ping the network 192.168.1.0/24, the specified command line could look like either: - fping -g 192.168.1.0/24 + $ fping -g 192.168.1.0/24 -or +or - fping -g 192.168.1.1 192.168.1.254 + $ fping -g 192.168.1.1 192.168.1.254 =item B<-h>, B<--help> Print usage message. +=item B<-H>, B<--ttl>=I + +Set the IP TTL field (time to live hops). + =item B<-i>, B<--interval>=I The minimum amount of time (in milliseconds) between sending a ping packet to any target (default is 25, minimum is 1). +=item B<-I>, B<--iface>=I + +Set the interface (requires SO_BINDTODEVICE support). + =item B<-l>, B<--loop> Loop sending packets to each target indefinitely. Can be interrupted with -Ctrl-C; statistics about responses for each target are then displayed. +Ctrl-C; statistics about responses for each target are then displayed. =item B<-m>, B<--all> @@ -141,7 +149,7 @@ Set the "Don't Fragment" bit in the IP header (used to determine/test the MTU). =item B<-n>, B<--name> If targets are specified as IP addresses, do a reverse-DNS lookup on them -to +to =item B<-N>, B<--netdata> @@ -154,7 +162,7 @@ Calculate "outage time" based on the number of lost pings and the interval used =item B<-O>, B<--tos>=I Set the typ of service flag (TOS). I can be either decimal or hexadecimal -(0xh) format. +(0xh) format. =item B<-p>, B<--period>= @@ -174,7 +182,7 @@ Like B<-q>, but show summary results every n seconds. =item B<-r>, B<--retry>=I Retry limit (default 3). This is the number of times an attempt at pinging -a target will be made, not including the first try. +a target will be made, not including the first try. =item B<-R>, B<--random> @@ -183,15 +191,11 @@ Use to defeat, e.g., link data compression. =item B<-s>, B<--src> -Print cumulative statistics upon exit. +Print cumulative statistics upon exit. =item B<-S>, B<--src>=I -Set source address. - -=item B<-I>, B<--iface>=I - -Set the interface (requires SO_BINDTODEVICE support) +Set source address. =item B<-t>, B<--timeout>=I @@ -203,19 +207,15 @@ B<-C>). =item B<-T> I -Ignored (for compatibility with fping 2.4). +Ignored (for compatibility with fping 2.4). =item B<-u>, B<--unreach> -Show targets that are unreachable. +Show targets that are unreachable. =item B<-v>, B<--version> -Print B version information. - -=item B<-H>, B<--ttl>=I - -Set the IP TTL field (time to live hops). +Print B version information. =back