Net::IPv6Addr - Check validity of IPv6 addresses
This documents version 0.8 of Net::IPv6Addr corresponding to git commit b65d6f2c96249d68b82c75f987070692411a4e3b released on Sat Sep 30 18:04:11 2017 +0900.
use Net::IPv6Addr; my $addr = "dead:beef:cafe:babe::f0ad"; Net::IPv6Addr::ipv6_parse($addr); my $x = Net::IPv6Addr->new($addr); print $x->to_string_preferred(), "\n";
produces output
dead:beef:cafe:babe:0:0:0:f0ad
(This example is included as synopsis.pl in the distribution.)
Net::IPv6Addr checks strings for valid IPv6 addresses, as specified in RFC1884, and converts addresses into various formats.
Net::IPv6Addr
This module is able to process addresses formatted in the following styles given in RFC1924:
Too many pattern matches to describe in this margin.
my $ni = Net::IPv6Addr->new ('dead:beef:cafe:babe::f0ad');
A string to be interpreted as an IPv6 address.
A Net::IPv6Addr object if successful.
Throws an exception if the string isn't a valid address.
my ($ni, $pl) = ipv6_parse ('dead:beef:cafe:babe::f0ad');
Either a string containing an IPv6 address string, which may also include a / character and a numeric prefix length,
/
my ($x, $y) = ipv6_parse ("a::/24");
or an IPv6 address string, with an optional second argument consisting of a numeric prefix length:
my ($x, $y) = ipv6_parse('a::', '24');
Called in array context, the return value is a list consisting of the address string and the prefix, if it parses correctly. Called in scalar context, the address and prefix are concatenated with "/".
Throws an exception on malformed input.
my $niok = is_ipv6 ('dead:beef:cafe:babe::f0ad');
Identical to "ipv6_parse".
This returns the return value of "ipv6_parse", called in scalar context, if it does parse out correctly, otherwise it returns undef.
undef
my $niok = ipv6_chkip ('dead:beef:cafe:babe::f0ad');
An IPv6 address string, without a prefix.
Something true if it's a valid address; something false otherwise.
my $tsp = $ni->to_string_preferred (); my $tsp = Net::IPv6Addr::to_string_preferred ('dead:beef:cafe:babe::f0ad');
If used as an object method, none; if used as a subroutine, an IPv6 address string in any format.
The IPv6 address, formatted in the "preferred" way (as detailed by RFC1884).
Invalid input will generate an exception.
The IPv6 address in the "compressed" format detailed by RFC1884.
The IPv6 address in the IPv4 format detailed by RFC1884.
Invalid input (such as an address that was not originally IPv4) will generate an exception.
The IPv6 address in the compressed IPv4 format detailed by RFC1884.
The IPv6 address in the style detailed by RFC1924.
The BigInt representation of IPv6 address.
An array [0..7] of 16 bit hexadecimal numbers.
An array [0..7] of decimal numbers.
This does not have any tests in the current test suite.
The reverse-address pointer as defined by RFC1886.
If used as an object method, network size in bits
my $ok = $x->in_network_of_size (64);
If used as a subroutine, an IPv6 address string in any format and network size in bits.
my $ok = Net::IPv6::in_network_of_size ($addr, 64);
Network size may be given with / notation:
my $ok = Net::IPv6::in_network_of_size ("$addr/64");
Network IPv6Addr of given size.
As of 0.8, this subroutine does not have any tests in the test suite.
my $ok = $x->in_network ("aa:bb:cc:dd::/64");
If used as an object method, a network and its size in bits
my $ok = $x->in_network ("aa:bb:cc:dd::", 64);
If used as a subroutine, an IPv6 address string in any format, followed by a network address string and its size in bits.
my $addr = 'fd00::54:20c:29fe:fe14:ab4b'; my $ok = Net::IPv6Addr::in_network ($addr, "aa:bb:cc:dd::", 64);
The network size may also be given with the / notation after the network address string:
my $ok = $x->in_network("aa:bb:cc:dd::/64");
A true value if the address is a member of the network, false otherwise.
As of 0.8, this subroutine has only minimal tests in the test suite.
As of version 0.8, "in_network", "in_network_of_size", "ipv6_chkip", "ipv6_parse", "is_ipv6" may be exported on demand. The other routines need to be called in fully-qualified format, like Net::IPv6Addr::is_ipv6. The exported functions may all be exported using
Net::IPv6Addr::is_ipv6
use Net::IPv6Addr ':all';
Known deficiencies include the following.
Many of the routines do not have any tests. This means that alterations to the code may have unintentionally altered the module's behaviour.
Report further bugs at https://rt.cpan.org/Dist/Display.html?Name=Net-IPv6Addr or by email to bug-Net-IPv6Addr [at] rt.cpan.org.
bug-Net-IPv6Addr [at] rt.cpan.org
Net::IPv4Addr, Math::Base85, Math::BigInt
Search grep.cpan.me for uses of this module
The following RFCs (requests for comment, internet standards documentation) contain information on IPv6.
RFC1884, RFC1886, RFC1924, RFC2373
The links go to the plain text online versions of the RFCs.
This module was originally written by Tony Monroe in 2001 to simplify the task of maintaining DNS records after he set himself up with Freenet6.
In 2017 the module was adopted by Ben Bullock with the help of Neil Bowers as part of "CPAN day".
Exporting of some functions was added in version 0.08.
Tony Monroe(*)
The module's interface resembles Net::IPv4Addr by Francis J. Lacoste <francis dot lacoste at iNsu dot COM>.
Some fixes and subroutines from Jyrki Soini <jyrki dot soini at sonera dot com>.
(*) The current module maintainer does not have any contact information for Tony Monroe. Those wishing to contact him can do so via Neil Bowers (see his CPAN user page for contact details).
This distribution is copyright (c) 2001-2002 Tony Monroe. All rights reserved. This software is distributed under the same license terms as Perl itself. This software comes with NO WARRANTIES WHATSOEVER, express, implied, or otherwise.
To install Net::IPv6Addr, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::IPv6Addr
CPAN shell
perl -MCPAN -e shell install Net::IPv6Addr
For more information on module installation, please visit the detailed CPAN module installation guide.