Adjust the fping man page to be Solaris specific.

These changes should probably be sent upstream, when the patch

can be reworked into a form that would be acceptable.

--- fping-2.4b2_to/fping.8.orig	2016-09-08 08:27:57.573911510 +0000

+++ fping-2.4b2_to/fping.8	2016-09-08 08:38:11.582287257 +0000

@@ -1,4 +1,4 @@

-.TH fping l

+.TH fping 8

 .SH NAME

 fping \- send ICMP ECHO_REQUEST packets to network hosts

 .SH SYNOPSIS

@@ -13,7 +13,7 @@

 .B fping 

 is a 

-.MS ping 8

+.B ping

 like program which uses the Internet Control

 Message Protocol (ICMP) echo request to determine if a target host is

 responding. 

@@ -83,13 +83,12 @@

 with the "-" indicating that no response was received to the fourth

 request.

 .IP \fB-d\fR 5

-Use DNS to lookup address of return ping packet. This allows you to give

+Use gethostbyaddr(3NSL) to lookup address of return ping packet. This allows you to give

 fping a list of IP addresses as input and print hostnames in the output.

 .IP \fB-e\fR 5

 Show elapsed (round-trip) time of packets.

 .IP \fB-f\fR 5

-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:

+Read list of targets from a file.

 % fping < targets_file

@@ -187,6 +186,121 @@

 }

 .ni

+.LP

+The following is an output example: 

+.sp

+\fB% fping a.b.com x.y.z.net 192.168.0.1 192.168.0.3\fR

+.in +2

+.nf

+a.b.com is alive

+x.y.z.net is alive

+192.168.0.1 is alive

+192.168.0.3 is alive

+.fi

+.in -2

+.sp

+.LP

+The following is an output example using the '-a' option: 

+.sp

+\fB% fping -a a.b.com x.y.z.net 192.168.0.1 192.168.0.3\fR

+.in +2

+.nf

+a.b.com

+x.y.z.net

+192.168.0.1

+192.168.0.3

+.fi

+.in -2

+.LP

+The following is an output example using the '-c' option: 

+.sp

+\fb% fping -c 3 a.b.com x.y.z.net 192.168.0.1\fR

+.in +2

+.nf

+a.b.com         : [0], 84 bytes, 51.1 ms (51.1 avg, 0% loss)

+192.168.0.1     : [0], 84 bytes, 0.08 ms (0.08 avg, 0% loss) [<- 192.168.0.4]

+x.y.z.net       : [0], 84 bytes, 70.6 ms (70.6 avg, 0% loss)

+a.b.com         : [1], 84 bytes, 60.9 ms (56.0 avg, 0% loss)

+192.168.0.1     : [1], 84 bytes, 0.09 ms (0.08 avg, 0% loss) [<- 192.168.0.4]

+a.b.com         : [2], 84 bytes, 40.6 ms (50.9 avg, 0% loss)

+192.168.0.1     : [2], 84 bytes, 0.11 ms (0.09 avg, 0% loss) [<- 192.168.0.4]

+x.y.z.net               : [2], 84 bytes, 68.8 ms (69.7 avg, 33% loss)

+.sp

+a.b.com         : xmt/rcv/%loss = 3/3/0%, min/avg/max = 40.6/50.9/60.9

+x.y.z.net               : xmt/rcv/%loss = 3/2/33%, min/avg/max = 68.8/69.7/70.6

+192.168.0.1     : xmt/rcv/%loss = 3/3/0%, min/avg/max = 0.08/0.09/0.11

+.fi

+.in -2

+.LP

+The following is an output example using the '-C' option: 

+.sp

+\fb% fping -C 3 a.b.com x.y.z.net 192.168.0.1\fR

+.in +2

+.nf

+a.b.com         : [0], 84 bytes, 41.7 ms (41.7 avg, 0% loss)

+x.y.z.net               : [0], 84 bytes, 66.6 ms (66.6 avg, 0% loss)

+a.b.com         : [1], 84 bytes, 50.7 ms (46.2 avg, 0% loss)

+x.y.z.net               : [1], 84 bytes, 62.6 ms (64.6 avg, 0% loss)

+a.b.com         : [2], 84 bytes, 44.9 ms (45.8 avg, 0% loss)

+x.y.z.net               : [2], 84 bytes, 69.5 ms (66.2 avg, 0% loss)

+.sp

+a.b.com         : 41.74 50.72 44.94

+x.y.z.net               : 66.69 62.63 69.52

+192.168.0.1     : - - -

+.fi

+.in -2

+.LP

+The following is an output example using the '-e' option: 

+.sp

+\fb% fping -e a.b.com x.y.z.net 192.168.0.1\fR

+.in +2

+.nf

+a.b.com is alive (18.9 ms)

+x.y.z.net is alive (9.51 ms)

+192.168.0.1 is alive (0.35 ms)

+.fi

+.in -2

+.LP

+The following is an output example using the '-g' option: 

+.sp

+\fb% fping -g 192.168.0.1 192.168.0.6\fR

+.in +2

+.nf

+192.168.0.0 is alive [<- 192.168.0.4]

+192.168.0.4 is alive

+192.168.0.1 is unreachable

+192.168.0.2 is unreachable

+192.168.0.3 is unreachable

+192.168.0.5 is unreachable

+192.168.0.6 is unreachable

+.fi

+.in -2

+.LP

+The following is an output example using the '-s' option: 

+.sp

+\fb% fping -s a.b.com x.y.z.net 192.168.0.1\fR

+.in +2

+.nf

+a.b.com is alive

+x.y.z.net is alive

+192.168.0.1 is unreachable

+

+       3 targets

+       2 alive

+       1 unreachable

+       0 unknown addresses

+

+       4 timeouts (waiting for response)

+       6 ICMP Echos sent

+       2 ICMP Echo Replies received

+       0 other ICMP received

+

+ 46.1 ms (min round trip time)

+ 58.7 ms (avg round trip time)

+ 71.3 ms (max round trip time)

+        4.153 sec (elapsed real time)

+.fi

+.in -2

 .SH AUTHORS

 .nf

@@ -202,19 +316,10 @@

 .SH BUGS

 Ha! If we knew of any we would have fixed them!

 .SH RESTRICTIONS

-If certain options are used (i.e, a low value for -i and -t, and a 

-high value for -r) it is possible to flood the network. This program

-must be installed as setuid root in order to open up a raw socket,

-or must be run by root. In order to stop mere mortals from hosing the

-network (when fping is installed setuid root) , normal users can't specify 

-the following:

-.nf

-

- -i n   where n < 10  msec

- -r n   where n > 20

- -t n   where n < 250 msec

+Successful execution of this program requires that it be granted

+the net_icmpaccess privilege.

 .ni

 .SH SEE ALSO

-netstat(1), ping(8), ifconfig(8c)

+netstat(8), ping(8), ifconfig(8), rbac(7), privileges(7)