NAME
   Net::Whois::ARIN - ARIN whois client

SYNOPSIS
     use Net::Whois::ARIN;

     my $w = Net::Whois::ARIN->new(
                 host    => 'whois.arin.net',
                 port    => 43,
                 timeout => 30,
             );

     #  fetch raw whois output as a list
     my $result = $w->query( '207.173.0.0' );

     #  fetch raw whois output as a scalar
     my @results = $w->query( 'NET-207-173-0-0-1' );

     #  get Net::Whois::ARIN::Network records
     my @output = $w->network( '207.173.0.0' );
     foreach my $net (@output) {
         printf(
             "%s\t(%s)\t%s\n",
             $net->OrgName,
             $net->NetHandle,
             $net->NetRange,
         );
     }

     my($asn) = $w->asn( 5650 );
     printf "AS5650 was assigned to %s\n", $asn->OrgName;
     printf "The email address for AS5650's technical point of contact is %s\n", $asn->TechEmail;

     my @contact = $w->contact('DM2339-ARIN');

     my @contact_records = $w->domain('eli.net');

     my @org = $w->organization('ELIX');

     my @customers = $w->customer('ELIX');

DESCRIPTION
   This module provides a Perl interface to the ARIN Whois server. The
   module takes care of connecting to an ARIN whois server, sending your
   whois requests, and parsing the whois output. The whois records are
   returned as lists of Net::Whois::ARIN::* instances.

METHODS
   In the calling conventions below "[]"'s represent optional parameters.

   new - create a Net::Whois::ARIN object
         my $o = Net::Whois::ARIN->new(
           [-hostname=> 'whois.arin.net',]
           [-port    => 43,]
           [-timeout => 45,]
           [-retries => 3,]
         );

       This is the constuctor for Net::Whois::ARIN. The object returned can
       be used to query the whois database.

   query - make a raw query to the whois server
         my @output = $o->query('207.173.112.0');

   network - request a network record
         my @records = $o->network('207.173.112.0');

       This method requires a single argument. The argument indicates the
       network to use in the whois lookup. The method returns a list of
       Net::Whois::ARIN::Network records that matched your search criteria.

   asn - request an ASN record
         my @record = $o->asn(5650);

       This method requires a single argument. The argument indicates the
       autonomous system number to use in the whois lookup. The method
       returns a list of Net::Whois::ARIN::AS objects.

   organization - request an organization record
         my @record = $w->org('ELIX');

   customer - request a customer record
         my @records = $w->customer('ELIX');

   contact - request a point-of-contact record
         my @record = $w->contact('DM2339-ARIN');

   domain - request all records from a given domain
         @output = $w->domain('eli.net');

SEE ALSO
   Net::Whois::ARIN::AS

   Net::Whois::ARIN::Network

   Net::Whois::ARIN::Contact

   Net::Whois::ARIN::Organization

   Net::Whois::ARIN::Customer

AUTHOR
   Todd Caine <todd.caine at gmail.com>

COPYRIGHT AND LICENSE
   Copyright (c) 2006 Todd Caine. All rights reserved.

   This program is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.