Net::DNS::SEC::Tools::TrustAnchor(3)       User Contributed Perl Documentation


NAME
       Net::DNS::SEC::Tools::TrustAnchor

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)

POD ERRORS
       Hey! The above document had some coding errors, which are explained
       below:

       Around line 32:
           You can't have =items (as at line 45) unless the first thing after
           the =over is an =item

perl v5.38.0                      2023-07-29
                                          Net::DNS::SEC::Tools::TrustAnchor(3)