Net::DNS::SEC::Tools::dnssectools.3pm

Langue: en

Version: 2010-06-25 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

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.

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 delievered 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 2006-2010 SPARTA, Inc. All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details.

AUTHOR

Wayne Morrison, tewok@users.sourceforge.net

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 344:
You forgot a '=back' before '=head1'