--- AnyEvent-FastPing/README 2007/05/15 19:25:08 1.4 +++ AnyEvent-FastPing/README 2008/04/27 15:43:51 1.5 @@ -1,11 +1,11 @@ NAME - Net::FPing - quickly ping a large number of hosts + AnyEvent::FastPing - quickly ping a large number of hosts SYNOPSIS - use Net::FPing; + use AnyEvent::FastPing; DESCRIPTION - This module was written for a single purpose only: sendinf ICMP EHCO + This module was written for a single purpose only: sending ICMP EHCO REQUEST packets as quickly as possible to a large number of hosts (thousands to millions). @@ -14,19 +14,20 @@ module. FUNCTIONS - Net::FPing::ipv4_supported + AnyEvent::FastPing::ipv4_supported Returns true if IPv4 is supported in this module and on this system. - Net::FPing::ipv6_supported + AnyEvent::FastPing::ipv6_supported Returns true if IPv6 is supported in this module and on this system. - Net::FPing::icmp4_pktsize + AnyEvent::FastPing::icmp4_pktsize Returns the number of bytes each IPv4 ping packet has. - Net::FPing::icmp6_pktsize + AnyEvent::FastPing::icmp6_pktsize Returns the number of bytes each IPv4 ping packet has. - Net::FPing::icmp_ping [ranges...], $send_interval, $payload, \&callback + AnyEvent::FastPing::icmp_ping [ranges...], $send_interval, $payload, + \&callback Ping the given IPv4 address ranges. Each range is an arrayref of the form "[lo, hi, interval]", where "lo" and "hi" are octet strings with either 4 octets (for IPv4 addresses) or 16 octets (for IPV6 @@ -73,9 +74,11 @@ my $done = AnyEvent->condvar; - Net::FPing::icmp_ping - [v10.0.0.1, v10.0.0.15, .01], - [v11.0.0.1, v11.0.255.255, .001], + AnyEvent::FastPing::icmp_ping + [ + [v10.0.0.1, v10.0.0.15, .01], + [v11.0.0.1, v11.0.255.255, .001], + ], .001, 0x12345678, sub { warn "all ranges pinged\n"; @@ -85,10 +88,10 @@ $done->wait; - Net::FPing::register_cb \&cb + AnyEvent::FastPing::register_cb \&cb Register a callback that is called for every received ping reply (regardless of whether a ping is still in process or not and - regardless of whether the reply is actually a reply ot a ping sent + regardless of whether the reply is actually a reply to a ping sent earlier). The code reference gets a single parameter - an arrayref with an @@ -123,7 +126,7 @@ ] ] - Net::FPing::unregister_cb \&cb + AnyEvent::FastPing::unregister_cb \&cb Unregister the callback again (make sure you pass the same codereference as to "register_cb").