net::ripewhois::in(3pm) [debian man page]

in(3pm) 						User Contributed Perl Documentation						   in(3pm)

NAME

       Net::RIPWhois::in - Perl extension for accessing inetnum objects from RIPE whois database.

SYNOPSIS

       use Net::RIPEWhois::in

       $in = new Net::RIPEWhois::in;

       @in = getIn($whois, $prefix, $ALLOCOPT);

       $whois->closeWhois();

DESCRIPTION

       Get inetnum objects from RIPE whois server. Validate as allocation object.

METHODS

   debug
       Get or set the debug.

       $in->debug(1); set the debug.

       $in->debug(undef);  turn off the $debug;

   error
       ($errNo, $errMsg) = $in->error; $in->(undef, undef, true); reset the error message

       Will get the last error no and error string;

       if $whois->debug is set	@{$in->{'errMsgAll'}}  and   @{$in->{'errNoAll'}} will have the list of all errors  and error numbers.

   new
       $in = new Net::RIPEWhois::in

       Creates a new inetnum object. ENV variables WHOISHOST and WHOISPORT

   getIn
       Return a list of inetnum objects returned by whois.

       $whois = new Net::RIPEWhois;

       @in = $in->getIn($whois, $prefix, $ALLOCOPT);

       Selected attributes of inetnum are stored in data structure i<inetnum>.	Should always query with fast raw output used by the RIPE whois
       db.

       $in->{inetnum}{attribute}

       return  undef on error. use $in->error() to get error no. and message.

   splitWhoisAns
       Split the response string from whois ans and return list of inetnum on sucess.

       @inList	= $in->splitWhoisAns( $whoisAnsRef);

       Returns undef on error.

       Spliting depending on fast raw output format from whois db. Use "-F" to get fast raw output.

   validAlloc
       Check the inetnum  is an alloation or not.

       Using netname  same as regid, translated "." to "-" .

       mnt-by RIPE-NCC-MNT ,RIPE-NCC-HM-MNT

       status  ALLOCATED PA, ALLOCATED PI, ALLOCATED UNSPECIFIED and not in IANA Delegated list. As specified in the specification when queried
       "-L" "-T" in the range database should return max 3 inetnum objects. Assignment, Allocation & IANA delegation to RIPE. Skip if it is an
       IANA delegation and aply the previous check.

       @valid = $in->validAlloc(@inlist);

       undef on error.

   checkYYYYmmDD
       Function used to check dates are valid or not. Converts to UTC on  YYYYMMDD and concert back to date format if these to matchs treated ad
       valid date.

       $YYYYMMDD = checkYYYYmmDD($YYYYMMDD); Accepts YYMMDD and YYYYMMDD formats. YYMMDD is treated as 19YYMMDD

FILES

       /ncc/ip-reg/delegations perl file with list of IANA delegations.

REQUIRES

       perl module ipv4pack

AUTHOR

       Antony <antony@ripe.net>  software group RIPE NCC <softies@ripe.net>

SEE ALSO

       perl(1), Net::RIPEWhois(3), whois(1)

perl v5.10.1							    2003-07-28								   in(3pm)

WHOIS(1)							 Debian GNU/Linux							  WHOIS(1)

NAME

       whois - client for the whois directory service

SYNOPSIS

       whois [ -h HOST ] [ -p  PORT ] [ -aCFHlLMmrRSVx ] [ -g SOURCE:FIRST-LAST ] [ -i ATTR ] [ -S SOURCE ] [ -T TYPE ] object

       whois [ -t ] [ -v ] template whois [ -q ] keyword

DESCRIPTION

       whois searches for an object in a RFC 3912 database.

       This  version  of the whois client tries to guess the right server to ask for the specified object. If no guess can be made it will connect
       to whois.networksolutions.com for NIC handles or whois.arin.net for IPv4 addresses and network names.

OPTIONS

       -h HOST Connect to HOST.

       -H      Do not display the legal disclaimers some registries like to show you.

       -p PORT Connect to PORT.

       --verbose
	       Be verbose.

       --help  Display online help.

       Other options are flags understood by RIPE-like servers.

NOTES

       Please remember that whois.networksolutions.com by default will only search in the domains database. If you want to search for NIC  handles
       you have to prepend a ! character. When you do this, the default server becomes whois.networksolutions.com.

       When querying whois.arin.net for IPv4 or IPv6 networks, the CIDR netmask length will be automatically removed from the query string.

       When  querying  whois.nic.ad.jp	for  AS numbers, the program will automatically convert the request in the appropriate format, inserting a
       space after the string AS.

       When querying whois.denic.de for domain names and no other flags have been specified, the program will automatically add the flag -T dn.

       When querying whois.dk-hostmaster.dk for domain names and no other flags have been specified, the program will automatically add  the  flag
       --show-handles.

       RIPE-specific  command  line options are ignored when querying non-RIPE servers. This may or may not be the behaviour intended by the user.
       When querying a non-standard server, command line options which are not to be interpreted by the client should always follow the -- separa-
       tor (which marks the beginning of the query string).

       If  the	/etc/whois.conf  config file exists, it will be consulted to find a server before applying the normal rules. Each line of the file
       should contain a regular expression to be matched against the query text and the whois server to use, separated by white space.

       The whois protocol does not specify an encoding for characters which cannot be represented by ASCII and implementations	vary  wildly.	If
       the  program  knows that a specific server uses a certain encoding, if needed it will transcode the server output to the encoding specified
       by the current system locale.

       Command line arguments will always be interpreted accordingly to the current system locale and converted to the IDN ASCII Compatible Encod-
       ing.

Files
       /etc/whois.conf

ENVIRONMENT

       LANG   When querying whois.nic.ad.jp and whois.jprs.jp english text is requested unless the LANG or LC_MESSAGES environment variables spec-
	      ify a Japanese locale.

       WHOIS_OPTIONS
	      A list of options which will be evalued before the ones specified on the command line.

       WHOIS_SERVER
	      This server will be queried if the program cannot guess where some kind of objects are located. If the variable does not exist  then
	      whois.arin.net will be queried.

SEE ALSO

       RFC 3912: WHOIS Protocol Specification

       RIPE-223: RIPE NCC Database Documentation

       Detailed help on available flags can be found in RIPE-223 or in the help file which can be obtained with the command:

	      whois -h whois.ripe.net HELP

BUGS

       The  program may have buffer overflows in the command line parser: be sure to not pass untrusted data to it.  It should be rewritten to use
       a dynamics strings library.

HISTORY

       This program closely tracks the user interface of the whois client developed at RIPE by Ambrose Magee and others on the base of the  origi-
       nal BSD client.	I also added support for the protocol extensions developed by David Kessens of QWest for the 6bone server.

AUTHOR

       Whois and this man page were written by Marco d'Itri <md@linux.it> and are licensed under the terms of the GNU General Public License, ver-
       sion 2 or higher.

Marco d'Itri							 20 December 2009							  WHOIS(1)