Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

www::cnic::simple(3pm) [debian man page]

WWW::CNic::Simple(3pm)					User Contributed Perl Documentation				    WWW::CNic::Simple(3pm)

NAME

       WWW::CNic::Simple - a procedural interface to WWW::CNic

SYNOPSIS

	       #!/usr/bin/perl
	       use WWW::CNic::Simple;

	       my @suffixes = suffixes();

	       my %results = check('test-domain', 'uk.com', 'uk.net');
	       print "test-domain.uk.com is registered.
" if ($results{'uk.com'} == 1);

	       my %whois = whois('test-domain.uk.com');
	       print "domain status: $whois{status}
";

DESCRIPTION

       This interface is intended for those who want a simplified view of the WWW::CNic library. It provides simple functions for querying the
       CentralNic system, making it ideal for one-liners and other tasks.

       Please note that it is not possible to make domain registrations or modifications using "WWW::CNic::Simple".

FUNCTIONS

	       my @suffixes = suffixes();

       This function returns an array containing the currently live CentralNic suffixes.

	       my %result = check($domain, @suffixes);

       This function does an availability check on $domain against the suffixes contained in @suffixes. Note that if @suffixes is omitted the
       check will run against all CentralNic domains.

       The function returns a hash of the form:

	       my %result = (  'uk.com'        => 1,
			       'uk.net'        => 0,
			       'eu.com'        => 0);

       where 1 indicates that the domain is already registered.

	       my %whois = whois($domain);

       This function returns a hash containing whois data for the given $domain This hash is of the form:

	       my %whois =     {       chandle	       => {    postcode        => 'SW6 4SN',
							       country	       => 'UK',
							       userid	       => 'C11480',
							       fax	       => 'N/A',
							       addr	       => "163 New King's Road, Fulham, London",
							       name	       => 'Hostmaster',
							       email	       => 'webservices@centralnic.com',
							       phone	       => '020 7751 9000',
							       company	       => 'CentralNic Ltd' },
				       expires	       => '1001458800',
				       status	       => 'Live',
				       thandle	       => # as chandle above
				       bhandle	       => # as chandle above
				       registrant      => 'CentralNic Ltd',
				       domain	       => 'toolkit-test.uk.com',
				       created	       => '1001458800'
				};

COPYRIGHT

       This module is (c) 2011 CentralNic Ltd. All rights reserved. This module is free software; you can redistribute it and/or modify it under
       the same terms as Perl itself.

SEE ALSO

       o   http://toolkit.centralnic.com/

       o   WWW::CNic

       o   WWW::CNic::Cookbook

perl v5.12.3							    2011-05-13						    WWW::CNic::Simple(3pm)

Check Out this Related Man Page

WWW::CNic::Response(3pm)				User Contributed Perl Documentation				  WWW::CNic::Response(3pm)

NAME

       WWW::CNic::Response - base class for WWW::CNic response objects.

SYNOPSIS

	       use WWW::CNic;

	       my $query = WWW::CNic->new( OPTIONS );

	       my $response = $query->execute();

DESCRIPTION

       This is the base class for all response objects returned by WWW::CNic. Each query type returns a different object, all of which inherit
       their basic functionality from this module.

       This module should never be accessed directly, only through its children.

METHODS

       All the child classes of WWW::CNic::Response inherit the following methods:

	       $response->is_success();

       This returns true if the transaction was completed successfully. If there was a server-side error due to invalid data or a system error, or
       there was an HTTP error this method will return undef.

	       $response->is_error();

       This is the converse of "is_success". It returns true if there was an error.

	       $response->error();

       This returns the error message generated, if any. This can be either a server-side error message or an HTTP error.

	       $response->message();

       This returns the message returned when the transaction was successful.

	       $response->keys();

       This returns an array containing all the keys returned by the server.

	       $response->response($key);

       This returns the value corresponding to $key as returned by the server. This may be a scalar, or a reference to an array or hash, depending
       on the context.

	       $response->dump();

       This prints a human-readable dump of the data stored in the object to "STDOUT". Mainly useful in debugging.

COPYRIGHT

       This module is (c) 2011 CentralNic Ltd. All rights reserved. This module is free software; you can redistribute it and/or modify it under
       the same terms as Perl itself.

SEE ALSO

       o   http://toolkit.centralnic.com/

       o   WWW::CNic

perl v5.12.3							    2011-05-13						  WWW::CNic::Response(3pm)
Man Page