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>