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>