ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent-FastPing/FastPing.pm
(Generate patch)

Comparing AnyEvent-FastPing/FastPing.pm (file contents):
Revision 1.4 by root, Mon Jun 2 09:09:31 2008 UTC vs.
Revision 1.10 by root, Sat Jan 29 23:55:37 2011 UTC

… …
21 21
22=cut 22=cut
23 23
24package AnyEvent::FastPing; 24package AnyEvent::FastPing;
25 25
26use strict; 26use common::sense;
27no warnings;
28 27
29use AnyEvent; 28use AnyEvent;
30 29
31BEGIN { 30BEGIN {
32 our $VERSION = '1.11'; 31 our $VERSION = '1.15';
33 our @ISA = qw(Exporter); 32 our @ISA = qw(Exporter);
34 33
35 require Exporter; 34 require Exporter;
36 #Exporter::export_ok_tags (keys %EXPORT_TAGS); 35 #Exporter::export_ok_tags (keys %EXPORT_TAGS);
37 36
… …
43 42
44our $THR_REQ_FH; open $THR_REQ_FH, ">&=$THR_REQ_FD" or die "FATAL: cannot fdopen"; 43our $THR_REQ_FH; open $THR_REQ_FH, ">&=$THR_REQ_FD" or die "FATAL: cannot fdopen";
45our $THR_RES_FH; open $THR_RES_FH, "<&=$THR_RES_FD" or die "FATAL: cannot fdopen"; 44our $THR_RES_FH; open $THR_RES_FH, "<&=$THR_RES_FD" or die "FATAL: cannot fdopen";
46 45
47our $THR_REQ_W; 46our $THR_REQ_W;
48our $THR_RES_W = AnyEvent->io (fh => $THR_RES_FH, poll => 'r', cb => sub { 47our $THR_RES_W = AE::io $THR_RES_FH, 0, sub {
49 my $sv = _read_res 48 my $sv = _read_res
50 or return; 49 or return;
51 50
52 $sv->(); 51 $sv->();
53}); 52};
54 53
55our $THR_REQ_BUF; 54our $THR_REQ_BUF;
56 55
57sub _send_req($) { 56sub _send_req($) {
58 $THR_REQ_BUF .= $_[0]; 57 $THR_REQ_BUF .= $_[0];
59 58
60 $THR_REQ_W ||= AnyEvent->io (fh => $THR_REQ_FH, poll => 'w', cb => sub { 59 $THR_REQ_W ||= AE::io $THR_REQ_FH, 1, sub {
61 my $len = syswrite $THR_REQ_FH, $THR_REQ_BUF; 60 my $len = syswrite $THR_REQ_FH, $THR_REQ_BUF;
62 substr $THR_REQ_BUF, 0, $len, ""; 61 substr $THR_REQ_BUF, 0, $len, "";
63 62
64 undef $THR_REQ_W unless length $THR_REQ_BUF; 63 undef $THR_REQ_W unless length $THR_REQ_BUF;
65 }); 64 };
66} 65}
67 66
68=item AnyEvent::FastPing::ipv4_supported 67=item AnyEvent::FastPing::ipv4_supported
69 68
70Returns true if IPv4 is supported in this module and on this system. 69Returns true if IPv4 is supported in this module and on this system.
… …
91range C<interval> is the minimum time in seconds between pings to the 90range C<interval> is the minimum time in seconds between pings to the
92given range. If omitted, defaults to C<$send_interval>. 91given range. If omitted, defaults to C<$send_interval>.
93 92
94The C<$send_interval> is the minimum interval between sending any two 93The C<$send_interval> is the minimum interval between sending any two
95packets and is a way to make an overall rate limit. If omitted, pings will 94packets and is a way to make an overall rate limit. If omitted, pings will
96be send as fast as possible. 95be sent as fast as possible.
97 96
98The C<$payload> is a 32 bit unsigned integer given as the ICMP ECHO 97The C<$payload> is a 32 bit unsigned integer given as the ICMP ECHO
99REQUEST ident and sequence numbers (in unspecified order :). 98REQUEST ident and sequence numbers (in unspecified order :).
100 99
101The request will be queued and all requests will be served by a background 100The request will be queued and all requests will be served by a background
… …
144 143
145sub icmp_ping($$$&) { 144sub icmp_ping($$$&) {
146 _send_req _req_icmp_ping @_; 145 _send_req _req_icmp_ping @_;
147} 146}
148 147
149our $ICMP4_FH; 148our $ICMP4_FH; our $ICMP4_W = $ICMP4_FD >= 0 && (open $ICMP4_FH, "<&=$ICMP4_FD") && AE::io $ICMP4_FH, 0, \&_recv_icmp4;
150our $ICMP4_W = (open $ICMP4_FH, "<&=$ICMP4_FD") && AnyEvent->io (fh => $ICMP4_FH, poll => 'r', cb => \&_recv_icmp4); 149our $ICMP6_FH; our $ICMP6_W = $ICMP6_FD >= 0 && (open $ICMP6_FH, "<&=$ICMP6_FD") && AE::io $ICMP6_FH, 0, \&_recv_icmp6;
151our $ICMP6_FH;
152our $ICMP6_W = (open $ICMP6_FH, "<&=$ICMP6_FD") && AnyEvent->io (fh => $ICMP6_FH, poll => 'r', cb => \&_recv_icmp6);
153 150
154=item AnyEvent::FastPing::register_cb \&cb 151=item AnyEvent::FastPing::register_cb \&cb
155 152
156Register a callback that is called for every received ping reply 153Register a callback that is called for every received ping reply
157(regardless of whether a ping is still in process or not and regardless of 154(regardless of whether a ping is still in process or not and regardless of
158whether the reply is actually a reply to a ping sent earlier). 155whether the reply is actually a reply to a ping sent earlier).
159 156
160The code reference gets a single parameter - an arrayref with an 157The code reference gets a single parameter - an arrayref with an
161entry for each received packet (replies are beign batched for greater 158entry for each received packet (replies are being batched for greater
162efficiency). Each packet is represented by an arrayref with three members: 159efficiency). Each packet is represented by an arrayref with three members:
163the source address (an octet string of either 4 (IPv4) or 16 (IPv6) octets 160the source address (an octet string of either 4 (IPv4) or 16 (IPv6) octets
164length), the payload as passed to C<icmp_ping> and the round trip time in 161length), the payload as passed to C<icmp_ping> and the round trip time in
165seconds. 162seconds.
163
164Example: register a callback which simply dumps the received data. Since
165the coderef is created on the fly via sub, it would be hard to unregister
166this callback again :)
167
168 AnyEvent::FastPing::register_cb sub {
169 for (@{$_[0]}) {
170 printf "%s %d %g\n",
171 (4 == length $_->[0] ? inet_ntoa $_->[0] : Socket6::inet_ntop (&AF_INET6, $_->[0])),
172 $_->[2],
173 $_->[1];
174 }
175 };
166 176
167Example: a single ping reply with payload of 1 from C<::1> gets passed 177Example: a single ping reply with payload of 1 from C<::1> gets passed
168like this: 178like this:
169 179
170 [ [ 180 [ [
… …
196 206
197=cut 207=cut
198 208
199our @CB; 209our @CB;
200 210
201sub register_cb(&) { 211sub register_cb($) {
202 push @CB, $_[0]; 212 push @CB, $_[0];
203} 213}
204 214
205sub unregister_cb($) { 215sub unregister_cb($) {
206 @CB = grep $_ != $_[0], @CB; 216 @CB = grep $_ != $_[0], @CB;

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines