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)