net::dns::sec::tools::bootstrap(3pm) [debian 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)

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

NAME

       Net::DNS::SEC::Tools::dnssectools - General routines for the DNSSEC-Tools package.

SYNOPSIS

	 use Net::DNS::SEC::Tools::dnssectools;

	 dt_adminmail($subject,$msgbody,$recipient);

	 $zspath = dt_cmdpath('zonesigner');

	 $ftype = dt_findtype($path);

DESCRIPTION

       The dnssectools module provides a general set of methods for use with DNSSEC-Tools utilities.

INTERFACES

       The interfaces to the dnssectools module are given below.

       dt_adminmail(subject,msgbody,recipient)
	   This routine emails a message to the administrative user listed in the DNSSEC-Tools configuration file.

	   dt_adminmail() requires two parameters, both scalars.  The subject parameter is the subject for the mail message.  The msgbody
	   parameter is the body of the mail message.

	   A third parameter, recipient, may be given to specify the message's recipient.  If this is not given, then the recipient will be taken
	   from the admin-email record of the DNSSEC-Tools configuration file.	If recipient is "nomail", then no message will be sent and success
	   will be returned.

	   Return values:

		   1 - the message was created and sent.
		   0 - an invalid recipient was specified.

       It relies on the the following dnssec-tools.conf configuration parameters:

       admin-email
	   The email address that the mail should come from.

       mailer-type
	   Should be one of: sendmail, smtp, qmail.  This option is not required and will default to trying sendmail and qmail to deliever the
	   mail.  If mailer-server is set to a defined value but mailer-type is not, then mailer-type will default to

       mailer-server
	   The server, if admin-mail is set to smtp, that the mail should be delivered to.

       dt_cmdpath(command)
	   This routine returns the path to a specified DNSSEC-Tools command.  command should be the name only, without any leading directories.
	   The command name is checked to ensure that it is a valid DNSEC-Tools command,

	   Return values:

		   The absolute path to the command is returned if the command
		   is valid.
		   Null is returned if the command is not valid.

       dt_filetype(path)
	   This routine returns the type of the file named in path.  The rollrec and keyrec records contained therein are counted and a type
	   determination is made.

	   Return values:

		   "keyrec" -  At least one keyrec record was found and no
			       rollrec records were found.

		   "rollrec" - At least one rollrec record was found and
			       no keyrec records were found.

		   "mixed" -   At least one rollrec record and at least one
			       keyrec record were found.
			       This is most likely an erroneous file.

		   "unknown" - No rollrec records nor keyrec records
			       were found.

		   "nofile"  - The specified file does not exist.

COPYRIGHT

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

AUTHOR

       Wayne Morrison, tewok@tislabs.com

SEE ALSO

       Mail::Send.pm(3), Net::DNS::SEC::Tools::conf.pm(3)

POD ERRORS

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

       Around line 309:
	   =back without =over

perl v5.14.2							    2012-06-28							  dnssectools(3pm)