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

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

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

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

The interfaces to the dnssectools module are given below.

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:

The email address that the mail should come from.
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
The server, if admin-mail is set to smtp, that the mail should be delivered to.
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.
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.
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.
This routine parses a given zone file using the configured zone file parser and returns an array reference containing the RRs.

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 zone parser will be used (obsolete option: this is the only currently supported parser).

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

Wayne Morrison, tewok@tislabs.com

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

2024-09-01 perl v5.40.0