IP::Authority
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 Inter-
net 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 fash-
ion.
$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 pur-
poses. 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 copy-
right statement is:
"Except for agreed Internet operational purposes, no part of this pub-
lication may be reproduced, stored in a retrieval system, or transmit-
ted, 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 suspi-
cions thereof."
LACNIC database copyright
Copyright (c) Latin American and Caribbean IP address Regional Reg-
istry. All rights reserved.
AFRINIC copyright
Seems to be the RIPE copyright. I’m sure they’ll correct this in due
course.
perl v5.8.8 2006-04-06 IP::Authority(3)
