src/oping.c: Allow setting of the TTL using `-t'.
[liboping.git] / src / mans / oping.pod
1 =head1 NAME
2
3 oping - send ICMP ECHO_REQUEST to network hosts
4
5 =head1 SYNOPSIS
6
7 B<oping> [B<-4> | B<-6>] [B<-c> I<count>] [B<-i> I<interval>] I<host> [I<host> [I<host> ...]]
8
9 =head1 DESCRIPTION
10
11 oping uses ICMPv4 or ICMPv6 ECHO_REQUEST packets to measure a hosts
12 reachability and the network latency. In contrast to the original L<ping(8)>
13 utility B<oping> can send ICMP packets to multiple hosts in parallel and wait
14 for all ECHO_RESPONSE packets to arrive. In contrast to the
15 B<fping> utility (URL is listed in L<"SEE ALSO">) B<oping> can use both, IPv4
16 and IPv6 transparently and side by side.
17
18 =head1 OPTIONS
19
20 =over 4
21
22 =item B<-4>
23
24 Force the use of IPv4. 
25
26 =item B<-6>
27
28 Force the use of IPv6
29
30 =item B<-c> I<count>
31
32 Send (and receive) I<count> ICMP packets, then stop and exit.
33
34 =item B<-i> I<interval>
35
36 Send one ICMP packet (per host) each I<interval> seconds. This can be a
37 floating-point number to specify sub-second precision.
38
39 =item B<-t> I<ttl>
40
41 Set the IP Time to Live to I<ttl>. This must be a number between (and
42 including) 1E<nbsp>andE<nbsp>255. If omitted, the value B<64> is used.
43
44 =item B<-I> I<address>
45
46 Set the source address to use. You B<cannot> pass the interface name, as you
47 can with GNU's L<ping(8)>.
48
49 =back
50
51 =head1 SEE ALSO
52
53 L<ping(8)>, L<http://www.fping.com/>, L<liboping(3)>
54
55 =head1 AUTHOR
56
57 liboping is written by Florian octo Forster E<lt>octo at verplant.orgE<gt>.
58 It's homepage can be found at L<http://verplant.org/liboping/>.
59
60 (c) 2005-2009 by Florian octo Forster.