NAME

       Net::DHCPv6::DUID::Parser - Parse DHCPv6 Unique Identifiers

SYNOPSIS

         use Net::DHCPv6::DUID::Parser;

         my $p = new Net::DHCPv6::DUID::Parser;

         # Decode an example DUID
         $p->decode('000300010004ED9F7622');

         # Print the type
         print "TYPE: ".$p->type(format => 'text')."\n";

         ### prints 'TYPE: DUID-LL'

         if ($p->type == 1 || $p->type == 3) {

           # Format this like a MAC address if the link type was Ethernet
           if ($p->iana_hw_type == 1) {
             print "MAC ADDRESS: ".$p->local_link_address(format => 'ethernet_mac')."\n";
           } else {
             print "LOCAL LINK ADDRESS: ".$p->local_link_address."\n";
           }

         }

         ### prints 'MAC ADDRESS: 00-04-ed-9f-76-22'

DESCRIPTION

       Object oriented interface to parse RFC3315 compliant DHCPv6 Unique Identifiers (DUIDs)

       This module was written for the purpose of splitting the DUID into its constituent parts,
       and shared here for convenience.  It does some textual conversions that may save you some
       time.

USAGE

   Methods
       Constructor

       •   Net::DHCPv6::DUID::Parser->new(..)

             my $p = new Net::DHCPv6::DUID::Parser (decode => 'hex');

           The constructor class method accepts two parameters.

           The 'decode' parameter tells the parser the format of the DUID you're intending to
           parse using the 'decode' object method.  Valid attributes are 'hex' and 'bin'. The
           default value is 'hex'.

           The 'warnings' parameter can be set to 0 to disable output to STDERR.  The default
           value is 1.

       Object Methods

       Each method returns undef if it encounters a failure, or if a requested DUID component
       wasn't relevant to the decoded DUID type.

       Warnings are emitted by default, unless turned off in the object constructor.

       •   $p->decode($duid)

           Accepts a single scalar, which should contain the DUID in the format indicated by the
           constructor.

           Returns 1 on success.

       •   $p->type(..)

           Applies to: DUID-LL, DUID-LLT and DUID-EN.

           Returns the DUID type.

           Specify "format => 'text'" to return the textual representation of the DUID type.  The
           default return value is numeric.

       •   $p->time()

           Applies to: DUID-LLT.

           Returns time ticks in seconds since midnight 1st January 2000.

       •   $p->iana_hw_type(..)

           Applies to: DUID-LL and DUID-LLT.

           Returns the IANA hardware type or undef if this parameter is irrelevant.

           Specify "format => 'text'" for a textual representation of this value.  The default
           return value is numeric.

       •   $p->enterprise_number()

           Applies to: DUID-EN.

           Returns the enterprise number.

       •   $p->identifier()

           Applies to: DUID-EN.

           Returns the identifier.

       •   $p->local_link_address(..)

           Applies to: DUID-LL and DUID-LLT

           Returns the local link address.

           Specify "format => 'ethernet_mac'" for a pretty representation of this value.

           The formatting will only apply if the IANA hardware type is '1' - i.e, if it's
           Ethernet.

CREDITS

       Mark Smith

SEE ALSO

       http://tools.ietf.org/html/rfc3315#section-9

AUTHOR

       Tom Wright, 2010