NAME

Liz::Whois - Perform Whois queries on any top level domain in the world


SYNOPSIS

 use Liz::Whois;

 $text = new Liz::Whois;


EXAMPLES

 #!/usr/local/bin/perl

 use Liz::Whois;

 $text = new Liz::Whois;
 $text = $text->Query( 'xxlink.nl' );


DESCRIPTION

The Liz::Whois package allows an easy to use interface for obtaining information about all the whois registries and databases for all top level domains in the world. It can do this by a built in database with knowledge about whois and http servers that supply this information.


BASIC METHODS

The following methods are the basic methods of the Liz::Whois module.


new

Create a new Liz::Whois object.

Output Parameters

 1 instantiated object
Example

 $text = new Liz::Whois;
 $text = Liz::Whois->new;


QUERY METHODS

The following method perform the query.


Query

Perform a whois (or similar) query to obtain information about the indicated domain.

Input Parameters

 1 top level domain to obtain information about
Output Parameters

 1 reference to list of texts of whois query
 2 reference to list of commands executed to obtain the info
Example

 ($text,$command) = $text->Query( 'xxLINK.nl' );
 foreach (0..$#$text) {
  print "$$command[$_]:\n$$text[$_]\n";
 }
Note

Defaults to printing the texts found if no return parameters are specified.


CONTENT METHODS

The following methods return information about the object, usually after a Query has been done..


Country

Return the country of the last Query performed.

Output Parameters

 1 country of the last query
Example

 $country = $whois->Country;


Default

Set or return the default whois server to be used.

Input Paremeters

 1 new whois server
   (default: no change)
Output Parameters

 1 current/previous whois server
Example

 $whois->Default( 'whois.internic.net' );
 $default = $whois->Default;


Domain

Return the domain of the last Query performed.

Output Parameters

 1 domain last checked
Example

 $domain = $whois->Domain;


Reason

Return the reason why the .nl domain of the last Query is blocked.

Output Parameters

 1 reason why a .nl domain is blocked
Example

 $reason = $whois->Reason;


Server

Return the server information of the last Query.

Output Parameters

 1 reason why a .nl domain is blocked
Example

 $reason = $whois->Reason;


TopLevel

Return the top level of the Domain of the last Query.

Output Parameters

 1 reason why a .nl domain is blocked
Example

 $toplevel = $whois->TopLevel;


AUTHOR

Elizabeth Mattijsen ( lizperl@INC.nl )

With contributions by:

- Hayo Rubingh ( hayo@xxLINK.nl )


COPYRIGHT

(C) 1999-2000 International Network Consultants


HISTORY

Version 0.15, 7 May 2000

Fixed whois server name for the .nl domain. Also fixed problem with non-existing .COM, .NET, .ORG and .EDU domains: they are now correctly returned.

Version 0.14, 15 December 1999

Now properly handles uppercase domain-names.

Added support for InterNIC sub-registries.

Version 0.13, 30 September 1999

Now no longer puts Exporter in ISA: it was not needed.

Version 0.12, 11 August 1998

Added support for looking up IP-number ownership to method Query.

Version 0.11, 28 July 1998

Added method Country, which returns the country of the last Query.

Version 0.1, 19 July 1998

First version of this true Perl module, based on routines developed in several internal user scripts.