Devil Killer Is Here MiNi Shell
MiNi SheLL

Current Path : /proc/thread-self/root/usr/local/man/man3/
Linux boscustweb5004.eigbox.net 5.4.91 #1 SMP Wed Jan 20 18:10:28 EST 2021 x86_64
Current File : //proc/thread-self/root/usr/local/man/man3/Net::ParseWhois.3
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Net::ParseWhois 3"
.TH Net::ParseWhois 3 "2001-04-14" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
Net::ParseWhois \- An extendable alternative to Net::Whois for parsing whois information.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  # below code based on t/whois.pl in Net::ParseWhois distribution package ...
.Ve
.PP
.Vb 1
\&  use Net::ParseWhois;
.Ve
.PP
.Vb 1
\&  my $dom = 'honestabe.net';
.Ve
.PP
.Vb 5
\&  my $w = Net::ParseWhois::Domain->new($dom);
\&  unless ($w->ok) {
\&        warn "error: " . $w->{'error'} . "\en" if $w->{'error'};
\&        die "No match for $dom\en";
\&  }
.Ve
.PP
.Vb 17
\&  print "Registrar: ", $w->registrar, "\en";
\&  print "Domain: ", $w->domain, "\en";
\&  print "Name: ", $w->name, "\en";
\&  print "Tag: ", $w->tag, "\en";
\&  print "Address:\en", map { "    $_\en" } $w->address;
\&  print "Country: ", $w->country, "\en";
\&  print "Name Servers:\en", map { "    $$_[0] ($$_[1])\en" }  @{$w->servers};
\&  my ($c, $t);
\&  if ($c = $w->contacts) {
\&    print "Contacts:\en";
\&    for $t (sort keys %$c) {
\&      print "    $t:\en";
\&      print map { "\et$_\en" } @{$$c{$t}};
\&    }
\&  }
\&  print "Record created:", $w->record_created ;
\&  print "\enRecord updated:", $w->record_updated,"\en";
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Net::ParseWhois currently only supports domains from major TLDs and Registrars (.com, .net & .org \*(--
see \s-1REGISTRARS\s0 for an exact list of who's supported) and tries to maintain backward interface
compatability with Net::Whois.
.PP
Net::ParseWhois is my attempt at updating Net::Whois to support whois referrals. The author
of Net::Whois (Dana Hudes) and I disgreed on how to solve the problem of parsing a distrubuted and 
non-standardized whois system, so I created this divergent module. (It's my understanding that
Mr. Hudes wants to create an \s-1IETF\s0 draft and assumes registrars/registries will then follow it.
I've simply taken the current not-so-defined situation and coded around it.) 
.PP
Net::ParseWhois contains a generalized parsing system that can be configured for each Registrar,
or completely overridden as needed. 
.PP
The class \f(CW\*(C`Net::ParseWhois::Domain::Registrar\*(C'\fR contains a list of known servers that could be 
returned in a whois referral, and specifies the specific class to use for each. When 
\&\f(CW\*(C`Net::ParseWhois\*(C'\fR receives a referral from the 'root' whois server, it creates the specified 
object and calls follow_referral on that object. If a domain is found and a referral given, but no 
Registrar class has been defined to handle that referral, the method \fIok\fR will return true
but method 'unknown_registrar' will also return true. Net::ParseWhois will still follow
the referral, and the raw output from the registrar will be available via the method
\&'raw_whois_text'.
.SH "REGISTRARS"
.IX Header "REGISTRARS"
Currently supported:
.PP
.Vb 11
\&        whois.dotster.com - Dotster, Inc.
\&        whois.register.com - Register.com, Inc.
\&        whois.networksolutions.com - Network Solutions, Inc.
\&        whois.opensrs.net - Tucows.com, Inc.
\&        whois.domaindiscover.com - Tierranet, Inc.
\&        whois.bulkregister.com - Bulkregister.com, Inc.
\&        rs.domainbank.net - Domain Bank, Inc.
\&        whois.registrars.com - INTERNET DOMAIN REGISTRARS (Shopnow?)
\&    whois.corenic.net - Core Internet Council of Registrars
\&    whois.InternetNamesWW.com -  Melbourne IT, aka Internet Names Worldwide
\&        whois.easyspace.com - Easyspace, Ltd.
.Ve
.PP
Not supported (with notes..):
.PP
.Vb 12
\&        whois.nordnet.net - should be easy.
\&        whois.namesecure.com - easy
\&        whois.compuserve.com - easy
\&        whois.itsyourdomain.com - easy
\&        whois.namesdirect.com - easy
\&        whois.enom.com - easy, but no nameserver or expire/updated data
\&        whois.domaininfo.com - not too hard. follows same structure, but uses different template/style
\&        whois.nameit.net - different style, not too hard
\&        whois.yesnic.com - Korean based registrar, field's are labeled. would require work.
\&        whois.gandi.net - French, RIPE style whois.
\&        whois.dotearth.com - might be ugly. no newlines between different sections
\&        whois.names4ever.com - no data?? down?
.Ve
.PP
.Vb 1
\&        Known registrars that I haven't looked at --
.Ve
.PP
.Vb 31
\&        whois.schlund.de
\&        whois.registrars.com
\&        whois.gandi.net
\&        whois.doregi.com
\&        whois.dotregistrar.com
\&        whois.ibi.net
\&        whois.OnlineNIC.com
\&        whois.paycenter.com.cn
\&        whois.domainpeople.com
\&        whois.awregistry.net
\&        whois.discount-domain.com
\&        whois.dotearth.com
\&        whois.psi-domains.com
\&        whois.gkg.net
\&        whois.enetregistry.com
\&        whois.speednic.net
\&        whois.domaininfo.com
\&        whois.catalog.com
\&        whois.oleane.net
\&        whois.totalnic.net
\&        whois.alldomains.com
\&        whois.signaturedomains.com
\&        whois.1stdomain.net
\&        whois.enterprice.net
\&        whois.stargateinc.com
\&        whois.e-names.org
\&        nswhois.domainregistry.com
\&        whois.worldnet.net
\&        whois.naame.com
\&        whois.eastcom.com
\&        whois.domainzoo.com
.Ve
.PP
Note: Now that CoreNic is supported (thanks Vern!), Net::ParseWhois's supported registrars
should cover upwards of 90% of the \s-1GTLD\s0 registrations that are out there.
.SH "COMMON METHODS (Specific to Net::ParseWhois)"
.IX Header "COMMON METHODS (Specific to Net::ParseWhois)"
.Vb 1
\& todo
.Ve
.SH "GENERIC METHODS (From Net::Whois)"
.IX Header "GENERIC METHODS (From Net::Whois)"
.Vb 1
\& todo
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
The Net::ParseWhois project homepage:
.PP
.Vb 1
\&    http://dajoba.com/projects/netparsewhois/
.Ve
.PP
The Net::ParseWhois mailing list:
.PP
.Vb 2
\&    netparsewhois at lists dot dajoba dot com
\&    http://lists.dajoba.com/m/listinfo/netparsewhois/
.Ve
.PP
Net::Whois, Net::Whois::Raw, Net::RWhois
.SH "AUTHORS / ACKNOWLEDGMENTS"
.IX Header "AUTHORS / ACKNOWLEDGMENTS"
Net::ParseWhois is maintained by Abraham A. Ingersoll <abe@dajoba.com>.
.PP
This module is a based on Net::Whois, which is maintained by
Dana Hudes (dhudes@hudes.org). Net::Whois was originally written by Chip 
Salzenberg (chip@pobox.com).
.PP
Thanks to:
.PP
Joseph Ingersoll for testing under ActivePerl.
Curtis Poe for comments and bug testing.
Andy Baio for first version of Registrars.pm.
Simon Flack for newer registrars.com parsing module & bug sleuthing.
Douglas Freake for (yet to be used) address parsing contribution.
Vern Hart for (especially tough) CoreNic.pm parsing module.
Adam Stubbs for INameWW.pm and Easyspace.pm parsing modules.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright 2000 Abraham A Ingersoll <abe@dajoba.com>
.PP
Some portions may be copyright 1998 Dana Hudes & Chip Salzenberg.
.PP
This module is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
Creat By MiNi SheLL
Email: devilkiller@gmail.com