NAME

       Net::DNS::SEC::Tools::TrustAnchor - base class for TA repositories

SYNOPSIS

       This is a base class for multiple types of trustanchor repositories that know how to read, write, and
       modify trust anchor repositories.

       This package serves as both a API wrapper around a set of trust anchors as well as a base class for
       packages that need to read/write trust anchor sets into different formats.

       Trust Anchors may be either DNSKEY records or DS references.

       XXX: more documentation needed

API

       Usage API defined by this module or sub-modules.

       Note that:

         use Net::DNS::SEC::Tools::TrustAnchor;

       is assumed to have imported some of the API routines mentioned below.

       $tar = new Net::DNS::SEC::Tools::TrustAnchor();
           Initializes a new collection of trust anchors.

       $module = load_module("type");
           Dynamically      attemps     to     load     a     TrustAnchor     reader/writer     sub-class     of
           Net::DNS::SEC::Tools::TrustAnchor named "Type" and return an instance of it.

           All sub-classes are assumed to contain a single letter upper-case class name followed  by  all  lower
           case.  Any modules otherwise named will fail to load using this routine.

       $module = parse_component("type:file");
           This parses a type and file specification consisting of type separated by a colon (':') followed by a
           file-name  path.   It  will  then  load the type module using the load_module() rotine and return the
           type, the file and extra options.

           XXX:  option  parsing  support  not  yet  complete  and  will  likely  change  the  type:file  format
           specification;  I.E.  the  type:file  formatting  specification  will likely change in the future and
           should be considered alpha-level support.

       $tar = $module->read($location, $options);
           Reads  in  a  given  TAR  from  a  $location  reference  and  returns   a   blessed   copy   of   the
           Net::DNS::SEC::Tools::TrustAnchor object containing all the data.

           This function may be over-ridden by a sub-class.

       $tar = $module->read($location, $options);
           Reads  in  a  given  TAR  from a $location reference and returns an unblessed hash the contents.  The
           read() function merely wraps around this and blesses it after being returned.

           Sub-modules must over-ride this function (and/or the read() function) if they expect  the  module  to
           support loading.

       $tar->merge(@others)
           Merges the @other array of trust anchors into the $tar object's own trust anchor list.

AUTHOR

       Wes Hardaker <hardaker ATTA users.sourceforge DOTTTY net>

SEE ALSO

       convertar(1)

perl v5.14.2                                       2013-07-10             Net::DNS::SEC::Tools::TrustAnchor(3pm)