Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
IP::Authority(3)      User Contributed Perl Documentation     IP::Authority(3)

NAME
       IP::Authority - fast lookup of authority	by IP address

SYNOPSIS
	 use IP::Authority;
	 my $reg = IP::Authority->new();
	 print $reg->inet_atoauth('212.67.197.128')   ."\n";
	 print $reg->inet_atoauth('www.slashdot.org') ."\n";

DESCRIPTION
       Historically, the former	InterNIC  managed (under the auspices of IANA)
       the allocation of IP numbers to ISPs and	other organizations. This
       changed somewhat	when the Regional Internet Registry system was
       started,	with the creation of three (and	later, four) Regional Internet
       Registries (RIRs) around	the world, each	managing the allocation	of IP
       addresses to organizations within differing physical areas (see also
       RFC2050).

       This means that there is	no central whois database for IP numbers.

       This module allows the user to lookup the RIR who has authority for a
       particular IP address. After finding out	the authority for an IP
       address,	it is possible to use the authority's whois server to lookup
       the netblock owner.

CONSTRUCTOR
       The constructor takes no	arguments.

	 use IP::Authority;
	 my $reg = IP::Authority->new();

OBJECT METHODS
       All object methods are designed to be used in an	object-oriented
       fashion.

	 $result = $object->foo_method($bar,$baz);

       Using the module	in a procedural	fashion	(without the arrow syntax)
       won't work.

       $auth = $reg->inet_atoauth(HOSTNAME)
	   Takes a string giving the name of a host, and translates that to an
	   two-letter string representing the regional Internet	registry that
	   has authority of that IP address:

	     AR	= ARIN (North America)
	     RI	= RIPE (Europe)
	     LA	= LACNIC (Latin	America)
	     AP	= APNIC	(Asia-Pacific)
	     AF	= AFRINIC (Africa and Indian Ocean)
	     IA	= IANA (see RFC3330)

	   Takes arguments of both the 'rtfm.mit.edu' type and '18.181.0.24'.
	   If the host name cannot be resolved,	returns	undef. If the resolved
	   IP address is not contained within the database, returns undef. For
	   multi-homed hosts (hosts with more than one address), the first
	   address found is returned.

       $auth = $reg->inet_ntoauth(IP_ADDRESS)
	   Takes a string (an opaque string as returned	by
	   Socket::inet_aton())	and translates it into a two-letter string
	   representing	the regional Internet registry that has	authority of
	   that	IP address:

	     AR	= ARIN (North America)
	     RI	= RIPE (Europe)
	     LA	= LACNIC (Latin	America)
	     AP	= APNIC	(Asia-Pacific)
	     AF	= AFRINIC (Africa and Indian Ocean)
	     IA	= IANA (see RFC3330)

	   If the IP address is	not contained within the database, returns
	   undef.

       $t = $reg->db_time()
	   Returns the creation	date of	the database, measured as number of
	   seconds since the Unix epoch	(00:00:00 GMT, January 1, 1970).
	   Suitable for	feeding	to "gmtime" and	"localtime".

BUGS/LIMITATIONS
       Only works with IPv4 addresses and ASCII	hostnames.

SEE ALSO
       IP::Country - fast lookup of country codes from IP address.

       <http://www.apnic.net> -	Asia-Pacific

       <http://www.ripe.net> - Europe

       <http://www.arin.net> - North America

       <http://www.lacnic.net> - Latin America

       <http://www.afrinic.net>	- Africa and Indian Ocean

COPYRIGHT
       Copyright (C) 2002-2005 Nigel Wetters Gourlay. All Rights Reserved.

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

       Some parts of this software distribution	are derived from the APNIC,
       LACNIC, ARIN, AFRINIC and RIPE databases	(copyright details below).  I
       am not a	lawyer,	so please direct questions about the RIR's licenses to
       them, not me.

APNIC conditions of use
       The files are freely available for download and use on the condition
       that APNIC will not be held responsible for any loss or damage arising
       from the	application of the information contained in these reports.

       APNIC endeavours	to the best of its ability to ensure the accuracy of
       these reports; however, APNIC makes no guarantee	in this	regard.

       In particular, it should	be noted that these reports seek to indicate
       the country where resources were	first allocated	or assigned. It	is not
       intended	that these reports be considered as an authoritative statement
       of the location in which	any specific resource may currently be in use.

ARIN database copyright
       Copyright (c) American Registry for Internet Numbers. All rights
       reserved.

       The ARIN	WHOIS data is for Internet operational or technical research
       purposes	pertaining to Internet operations only.	 It may	not be used
       for advertising,	direct marketing, marketing research, or similar
       purposes.  Use of the ARIN WHOIS	data for these activities is
       explicitly forbidden.  ARIN requests to be notified of any such
       activities or suspicions	thereof.

RIPE database copyright
       The information in the RIPE Database is available to the	public for
       agreed Internet operation purposes, but is under	copyright.  The
       copyright statement is:

       "Except for agreed Internet operational purposes, no part of this
       publication may be reproduced, stored in	a retrieval system, or
       transmitted, in any form	or by any means, electronic, mechanical,
       recording, or otherwise,	without	prior permission of the	RIPE NCC on
       behalf of the copyright holders.	Any use	of this	material to target
       advertising or similar activities is explicitly forbidden and may be
       prosecuted.  The	RIPE NCC requests to be	notified of any	such
       activities or suspicions	thereof."

LACNIC database	copyright
       Copyright (c) Latin American and	Caribbean IP address Regional
       Registry. All rights reserved.

AFRINIC	copyright
       Seems to	be the RIPE copyright. I'm sure	they'll	correct	this in	due
       course.

perl v5.24.1			  2013-05-15		      IP::Authority(3)

NAME | SYNOPSIS | DESCRIPTION | CONSTRUCTOR | OBJECT METHODS | BUGS/LIMITATIONS | SEE ALSO | COPYRIGHT | APNIC conditions of use | ARIN database copyright | RIPE database copyright | LACNIC database copyright | AFRINIC copyright

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=IP::Authority&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help