NAME

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

SYNOPSIS

  use Net::pWhoIs;

  my $obj = Net::pWhoIs->new();

  # You may pass hostnames or IP addresses.
  my @array = qw(
      166.70.12.30
      207.20.243.105
      67.225.131.208
      perlmonks.org
      8.8.8.8
      12.12.12.12
      ftp2.freebsd.org
  );

  # You can pass an array.
  my $output = $obj->pwhois(\@array);

  # Or you can pass a single string.
  my $output = $obj->pwhois('8.8.8.8');

  # Generate a formatted report.
  print $obj->printReport($output);

  # Or manipulate the data yourself.
  for my $req (keys %{$output}) {
      printf ("Request: %s\n", $req);
      for my $key (keys %{$output->{$req}}) {
          print sprintf("%-22s : %s\n", $key, $output->{$req}{$key});
      }
  }

DESCRIPTION

Client library for pWhois service. Includes support for bulk queries.

CONSTRUCTOR

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

Construct a new Net::pWhoIs object and return 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           Required argument, value must be an array reference.

METHODS

The following methods are available:

Net::pWhoIs->pwhois()

Perform queries on passed arrayref. Supports single or bulk query. Returns a hash of hashrefs.

Net::pWhoIs->printReport()

Perform queries on passed arrayref. Supports single or bulk query. Returns a hash of hashrefs.

Client

A full featured client is included: pwhoiscli.pl. Pass it hostnames or IP seperated by space.

OUTPUT HASHREF KEYS

The following is the list hashref keys returned by pwhois.

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

AUTHOR

Matt Hersant <matt_hersant@yahoo.com>