Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

net::dns::sec::tools::trustanchor(3pm) [debian man page]

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

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							    2012-06-28				    Net::DNS::SEC::Tools::TrustAnchor(3pm)

Check Out this Related Man Page

BootStrap(3pm)						User Contributed Perl Documentation					    BootStrap(3pm)

NAME

       Net::DNS::SEC::Tools::BootStrap - Optional loading of Perl modules

SYNOPSIS

	 use Net::DNS::SEC::Tools::BootStrap;

	 dnssec_tools_load_mods(
	    PerlModule => 'Additional help/error text'
	 );

DESCRIPTION

       The DNSSEC-Tools package requires a number of Perl modules that are only needed by some of the tools.  This module helps determine at run-
       time, rather than at installation time, if the right tools are available on the system.	If any module fails to load,
       dnssec_tools_load_mods() will display an error message and calls exit().  The error message describes how to install a module via CPAN.

       The arguments to dnssec_tools_load_mods() are given in pairs.  Each pair is a module to try to load (and import) and a supplemental error
       message.  If the module fails to load, the supplemental error message will be displayed along with the installation-via-CPAN message.  If
       the error message consists of the string "noerror", then no error message will be displayed before the function exits.

CAVEATS

       The module will try to import any exported subroutines from the module into the main namespace.	This means that the BootStrap.pm module is
       likely to not be useful for importing symbols into other modules.  Work-arounds for this are:

       - import the symbols by hand
	     dnssec_tools_load_mods(
		PerlModule => 'Additional help/error text'
	     );

	     import PerlModule qw(func1 func2);

	     func1(arg1, arg2);

       - call the fully qualified function name
	     dnssec_tools_load_mods(
		PerlModule => 'Additional help/error text'
	     );

	     PerlModule::func1(arg1, arg2);

COPYRIGHT

       Copyright 2006-2012 SPARTA, Inc.  All rights reserved.  See the COPYING file included with the DNSSEC-Tools package for details.

AUTHOR

       Wes Hardaker <hardaker@users.sourceforge.net>

SEE ALSO

       http://www.dnssec-tools.org/

perl v5.14.2							    2012-01-27							    BootStrap(3pm)
Man Page