|
1 Adjust the fping man page to be Solaris specific. |
|
2 |
|
3 These changes should probably be sent upstream, when the patch |
|
4 can be reworked into a form that would be acceptable. |
|
5 |
|
6 --- fping-2.4b2_to/fping.8.orig 2016-09-08 08:27:57.573911510 +0000 |
|
7 +++ fping-2.4b2_to/fping.8 2016-09-08 08:38:11.582287257 +0000 |
|
8 @@ -1,4 +1,4 @@ |
|
9 -.TH fping l |
|
10 +.TH fping 8 |
|
11 .SH NAME |
|
12 fping \- send ICMP ECHO_REQUEST packets to network hosts |
|
13 .SH SYNOPSIS |
|
14 @@ -13,7 +13,7 @@ |
|
15 |
|
16 .B fping |
|
17 is a |
|
18 -.MS ping 8 |
|
19 +.B ping |
|
20 like program which uses the Internet Control |
|
21 Message Protocol (ICMP) echo request to determine if a target host is |
|
22 responding. |
|
23 @@ -83,13 +83,12 @@ |
|
24 with the "-" indicating that no response was received to the fourth |
|
25 request. |
|
26 .IP \fB-d\fR 5 |
|
27 -Use DNS to lookup address of return ping packet. This allows you to give |
|
28 +Use gethostbyaddr(3NSL) to lookup address of return ping packet. This allows you to give |
|
29 fping a list of IP addresses as input and print hostnames in the output. |
|
30 .IP \fB-e\fR 5 |
|
31 Show elapsed (round-trip) time of packets. |
|
32 .IP \fB-f\fR 5 |
|
33 -Read list of targets from a file. This option can only be used by the |
|
34 -root user. Regular users should pipe in the file via stdin: |
|
35 +Read list of targets from a file. |
|
36 |
|
37 % fping < targets_file |
|
38 |
|
39 @@ -187,6 +186,121 @@ |
|
40 } |
|
41 |
|
42 .ni |
|
43 +.LP |
|
44 +The following is an output example: |
|
45 +.sp |
|
46 +\fB% fping a.b.com x.y.z.net 192.168.0.1 192.168.0.3\fR |
|
47 +.in +2 |
|
48 +.nf |
|
49 +a.b.com is alive |
|
50 +x.y.z.net is alive |
|
51 +192.168.0.1 is alive |
|
52 +192.168.0.3 is alive |
|
53 +.fi |
|
54 +.in -2 |
|
55 +.sp |
|
56 +.LP |
|
57 +The following is an output example using the '-a' option: |
|
58 +.sp |
|
59 +\fB% fping -a a.b.com x.y.z.net 192.168.0.1 192.168.0.3\fR |
|
60 +.in +2 |
|
61 +.nf |
|
62 +a.b.com |
|
63 +x.y.z.net |
|
64 +192.168.0.1 |
|
65 +192.168.0.3 |
|
66 +.fi |
|
67 +.in -2 |
|
68 +.LP |
|
69 +The following is an output example using the '-c' option: |
|
70 +.sp |
|
71 +\fb% fping -c 3 a.b.com x.y.z.net 192.168.0.1\fR |
|
72 +.in +2 |
|
73 +.nf |
|
74 +a.b.com : [0], 84 bytes, 51.1 ms (51.1 avg, 0% loss) |
|
75 +192.168.0.1 : [0], 84 bytes, 0.08 ms (0.08 avg, 0% loss) [<- 192.168.0.4] |
|
76 +x.y.z.net : [0], 84 bytes, 70.6 ms (70.6 avg, 0% loss) |
|
77 +a.b.com : [1], 84 bytes, 60.9 ms (56.0 avg, 0% loss) |
|
78 +192.168.0.1 : [1], 84 bytes, 0.09 ms (0.08 avg, 0% loss) [<- 192.168.0.4] |
|
79 +a.b.com : [2], 84 bytes, 40.6 ms (50.9 avg, 0% loss) |
|
80 +192.168.0.1 : [2], 84 bytes, 0.11 ms (0.09 avg, 0% loss) [<- 192.168.0.4] |
|
81 +x.y.z.net : [2], 84 bytes, 68.8 ms (69.7 avg, 33% loss) |
|
82 +.sp |
|
83 +a.b.com : xmt/rcv/%loss = 3/3/0%, min/avg/max = 40.6/50.9/60.9 |
|
84 +x.y.z.net : xmt/rcv/%loss = 3/2/33%, min/avg/max = 68.8/69.7/70.6 |
|
85 +192.168.0.1 : xmt/rcv/%loss = 3/3/0%, min/avg/max = 0.08/0.09/0.11 |
|
86 +.fi |
|
87 +.in -2 |
|
88 +.LP |
|
89 +The following is an output example using the '-C' option: |
|
90 +.sp |
|
91 +\fb% fping -C 3 a.b.com x.y.z.net 192.168.0.1\fR |
|
92 +.in +2 |
|
93 +.nf |
|
94 +a.b.com : [0], 84 bytes, 41.7 ms (41.7 avg, 0% loss) |
|
95 +x.y.z.net : [0], 84 bytes, 66.6 ms (66.6 avg, 0% loss) |
|
96 +a.b.com : [1], 84 bytes, 50.7 ms (46.2 avg, 0% loss) |
|
97 +x.y.z.net : [1], 84 bytes, 62.6 ms (64.6 avg, 0% loss) |
|
98 +a.b.com : [2], 84 bytes, 44.9 ms (45.8 avg, 0% loss) |
|
99 +x.y.z.net : [2], 84 bytes, 69.5 ms (66.2 avg, 0% loss) |
|
100 +.sp |
|
101 +a.b.com : 41.74 50.72 44.94 |
|
102 +x.y.z.net : 66.69 62.63 69.52 |
|
103 +192.168.0.1 : - - - |
|
104 +.fi |
|
105 +.in -2 |
|
106 +.LP |
|
107 +The following is an output example using the '-e' option: |
|
108 +.sp |
|
109 +\fb% fping -e a.b.com x.y.z.net 192.168.0.1\fR |
|
110 +.in +2 |
|
111 +.nf |
|
112 +a.b.com is alive (18.9 ms) |
|
113 +x.y.z.net is alive (9.51 ms) |
|
114 +192.168.0.1 is alive (0.35 ms) |
|
115 +.fi |
|
116 +.in -2 |
|
117 +.LP |
|
118 +The following is an output example using the '-g' option: |
|
119 +.sp |
|
120 +\fb% fping -g 192.168.0.1 192.168.0.6\fR |
|
121 +.in +2 |
|
122 +.nf |
|
123 +192.168.0.0 is alive [<- 192.168.0.4] |
|
124 +192.168.0.4 is alive |
|
125 +192.168.0.1 is unreachable |
|
126 +192.168.0.2 is unreachable |
|
127 +192.168.0.3 is unreachable |
|
128 +192.168.0.5 is unreachable |
|
129 +192.168.0.6 is unreachable |
|
130 +.fi |
|
131 +.in -2 |
|
132 +.LP |
|
133 +The following is an output example using the '-s' option: |
|
134 +.sp |
|
135 +\fb% fping -s a.b.com x.y.z.net 192.168.0.1\fR |
|
136 +.in +2 |
|
137 +.nf |
|
138 +a.b.com is alive |
|
139 +x.y.z.net is alive |
|
140 +192.168.0.1 is unreachable |
|
141 + |
|
142 + 3 targets |
|
143 + 2 alive |
|
144 + 1 unreachable |
|
145 + 0 unknown addresses |
|
146 + |
|
147 + 4 timeouts (waiting for response) |
|
148 + 6 ICMP Echos sent |
|
149 + 2 ICMP Echo Replies received |
|
150 + 0 other ICMP received |
|
151 + |
|
152 + 46.1 ms (min round trip time) |
|
153 + 58.7 ms (avg round trip time) |
|
154 + 71.3 ms (max round trip time) |
|
155 + 4.153 sec (elapsed real time) |
|
156 +.fi |
|
157 +.in -2 |
|
158 |
|
159 .SH AUTHORS |
|
160 .nf |
|
161 @@ -202,19 +316,10 @@ |
|
162 .SH BUGS |
|
163 Ha! If we knew of any we would have fixed them! |
|
164 .SH RESTRICTIONS |
|
165 -If certain options are used (i.e, a low value for -i and -t, and a |
|
166 -high value for -r) it is possible to flood the network. This program |
|
167 -must be installed as setuid root in order to open up a raw socket, |
|
168 -or must be run by root. In order to stop mere mortals from hosing the |
|
169 -network (when fping is installed setuid root) , normal users can't specify |
|
170 -the following: |
|
171 -.nf |
|
172 - |
|
173 - -i n where n < 10 msec |
|
174 - -r n where n > 20 |
|
175 - -t n where n < 250 msec |
|
176 +Successful execution of this program requires that it be granted |
|
177 +the net_icmpaccess privilege. |
|
178 |
|
179 .ni |
|
180 .SH SEE ALSO |
|
181 -netstat(1), ping(8), ifconfig(8c) |
|
182 +netstat(8), ping(8), ifconfig(8), rbac(7), privileges(7) |
|
183 |