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);

         $seconds = dt_parse_duration("0w3d1h10m20s")

         $rrset = dt_parse_zonefile(file => 'example.com');

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 deliver 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.

       dt_parse_duration(string)
           This  routine translates a duration given in "1w2d3h4m5s" format and returns the equivalent number of
           seconds, or undef if the duration has an invalid format.

       dt_parse_zonefile(options)
           This routine parses a given zone file using the configured zone file  parser  and  returns  an  array
           reference containing the RRs. The options hash is the same as for Net::DNS::ZoneFile::Fast.

           The  zone  parser  to  be used depends on the setting of the zonefile-parser configuration value.  If
           this is not set, then the Net::DNS::ZoneFile::Fast zone parser will be used.

COPYRIGHT

       Copyright 2006-2013 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 519:
           =back without =over

perl v5.14.2                                       2013-07-10                                   dnssectools(3pm)