NAME

Net::pWhoIs - Client library for Prefix WhoIs (pWhois)

SYNOPSIS

use Net::pWhoIs;

my %attrs = ( req => '166.70.12.30' );
my $obj = Net::pWhoIs->new(\%attrs);
my $output = $obj->pwhois();
# Output for single query is hashref.
for my $elmt (qw{org-name country city region}) {
    print $output->{$elmt}, "\n";
}

# Bulk query, combination of IPs and hostnames.
my @list = ('166.70.12.30', '207.20.243.105', '67.225.131.208', 'perlmonks.org');
my $obj = Net::pWhoIs->new({ req => \@list });
# Output for bulk queries is array of hashrefs.
my $output = $obj->pwhois();

use Data::Dumper;
print Dumper($output);

DESCRIPTION

Client for pWhois service. Includes support for bulk queries.

CONSTRUCTOR

The following constructor methods are available:

$obj = Net::pWhoIs->new( %options )

This method constructs a new Net::pWhoIs object and returns it. Key/value pair arguments may be provided to set up the initial state. The only require argument is: req.

pwhoisserver  whois.pwhois.org
port          43
req           Rlequired argument, may be scalar or array

METHODS

The following methods are available:

Net::pWhoIs->pwhois()

Perform a single query. Returns a hashref.

Net::pWhoIs->pwhoisBulk()

Perform bulk queries using a single socket. Returns an array of hashrefs. This method is called by Net::pWhoIs->pwhois() if the req argument is an array.

HASHREF KEYS

The following list hashref keys returned by pwhois or pwhoisBulk.

ip
as-org-name
as-path
origin-as
org-name
country-code
prefix
net-name
latitude
longitude
cache-date
city
region
country

AUTHOR

Mat Hersant <matt_hersant@yahoo.com>