]> git.gsnw.org Git - fping.git/commitdiff
sort options, remove whitespace
authorDavid Schweikert <david@schweikert.ch>
Mon, 13 Feb 2017 16:39:27 +0000 (17:39 +0100)
committerDavid Schweikert <david@schweikert.ch>
Mon, 13 Feb 2017 16:39:27 +0000 (17:39 +0100)
doc/fping.pod

index 30fd956a945b39852eae85956018456e0b4de8b0..9761f3807a7533ebaef07d8d17e6b3c5acf00977 100644 (file)
@@ -4,7 +4,7 @@ fping - send ICMP ECHO_REQUEST packets to network hosts
 
 =head1 SYNOPSIS
 
-B<fping> [ I<options> ] [ I<systems...> ] 
+B<fping> [ I<options> ] [ I<systems...> ]
 
 =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<ping>. 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<N>
 
@@ -58,25 +58,25 @@ Backoff factor. In the default mode, B<fping> 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<N>
 
 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<N>
 
 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<addr/mask>
 
@@ -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<N>
+
+Set the IP TTL field (time to live hops).
+
 =item B<-i>, B<--interval>=I<MSEC>
 
 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<IFACE>
+
+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<N>
 
 Set the typ of service flag (TOS). I<N> can be either decimal or hexadecimal
-(0xh) format. 
+(0xh) format.
 
 =item B<-p>, B<--period>=<MSEC>
 
@@ -174,7 +182,7 @@ Like B<-q>, but show summary results every n seconds.
 =item B<-r>, B<--retry>=I<N>
 
 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<addr>
 
-Set source address. 
-
-=item B<-I>, B<--iface>=I<IFACE>
-
-Set the interface (requires SO_BINDTODEVICE support) 
+Set source address.
 
 =item B<-t>, B<--timeout>=I<MSEC>
 
@@ -203,19 +207,15 @@ B<-C>).
 
 =item B<-T> I<n>
 
-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<fping> version information. 
-
-=item B<-H>, B<--ttl>=I<N>
-
-Set the IP TTL field (time to live hops). 
+Print B<fping> version information.
 
 =back