.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "SEC 3pm"
.TH SEC 3pm "2010-03-12" "perl v5.12.4" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Net::DNS::SEC \- DNSSEC extensions to Net::DNS
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\f(CW\*(C`use Net::DNS;\*(C'\fR
.PP
The Net::DNS::SEC module implements a few class methods used by the
other modules in this suite and a few functions that can be exported.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The Net::DSN::SEC suite provides the resource records that are needed
for \s-1DNSSEC\s0 (\s-1RFC\s0 4033, 4034 and 4035). In addition the \s-1DLV\s0 \s-1RR\s0, a clone
of the \s-1DS\s0 \s-1RR\s0 is supported (\s-1RFC\s0 4431)
.PP
It also provides support for \s-1SIG0\s0. That later is useful for dynamic
updates using key-pairs.
.PP
\&\s-1RSA\s0 and \s-1DSA\s0 crypto routines are supported.
.PP
For details see Net::DNS::RR::RRSIG, Net::DNS::RR::DNSKEY,
Net::DNS::RR::NSEC, Net::DNS::RR:DS, Net::DNS::RR::DLV, and
see Net::DNS::RR::SIG and Net::DNS::RR::KEY for the use with
\&\s-1SIG0\s0.
.PP
Net::DNS contains all needed hooks to load the Net::DNS::SEC
extensions when they are available.
.PP
See Net::DNS for general help.
.SH "Utility function"
.IX Header "Utility function"
Use the following construct if you want to use thos function in your code.
.PP
.Vb 1
\&   use Net::DNS::SEC qw( key_difference );
.Ve
.SS "key_difference"
.IX Subsection "key_difference"
.Vb 1
\&    $result=key_differnece(\e@a,\e@b,\e@result);
.Ve
.PP
Fills \f(CW@result\fR with all keys in the array \*(L"@a\*(R" that are not in the
array \*(L"@b\*(R".
.PP
Returns 0 on success or an error message on failure.
.SH "Class methods"
.IX Header "Class methods"
These functions are inherited by relevant Net::DNS::RR classes. They
are not exported.
.SS "algorithm"
.IX Subsection "algorithm"
.Vb 3
\&    $value=Net::DNS::SEC\->algorithm("RSASHA1");
\&    $value=$self\->algorithm("RSASHA1");
\&    $value=$self\->algorithm(5);
\&
\&    $algorithm=$self\->algorithm();
\&    $memonic=$self\->algorithm("mnemonic");
.Ve
.PP
The algorithm method is used to set or read the value of the algorithm
field in Net::DNS::RR::DNSKEY and Net::DNS::RR::RRSIG.
.PP
If supplied with an argument it will set the algorithm accordingly, except
when the argument equals the string \*(L"mnemonic\*(R" the method will return the
mnemonic of the algorithm.
.PP
Can also be called as a class method to do Mnemonic to Value conversion.
.SS "digtype"
.IX Subsection "digtype"
.Vb 2
\&    $value=$self\->digtype("SHA1");
\&    $value=$self\->digtype(1);
\&
\&    $algorithm=$self\->digtype();
\&    $memonic=$self\->digtype("mnemonic");
.Ve
.PP
The algorithm method is used to set or read the value of the digest or
hash algorithm field in Net::DNS::RR::DS and Net::DNS::RR::NSEC3
objects.
.PP
If supplied with an argument it will set the digetstype/hash algorithm
accordingly, except when the argument equals the string \*(L"mnemonic\*(R" the
method will return the mnemonic of the digetstype/hash algorithm.
.PP
Can also be called as a class method to do Mnemonic to Value
conversion, note however that it will then use the \*(L"Delegation Signer
(\s-1DS\s0) Resource Record (\s-1RR\s0) Type Digest Algorithms\*(R" and not the \*(L"\s-1DNSSEC\s0
\&\s-1NSEC3\s0 Hash Algorithms\*(R" \s-1IANA\s0 registry. If you want to specifically get
access to the \s-1NSEC3\s0  digest types then use a construct like:
.PP
.Vb 2
\& bless $self, Net::DNS::RR::NSEC3;
\& $self\->digtype("SHA1");
.Ve
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 2001\-2005  \s-1RIPE\s0 \s-1NCC\s0.  Author Olaf M. Kolkman <olaf@net\-dns.org>
.PP
All Rights Reserved
.PP
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation, and that the name of the author not be
used in advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
.PP
\&\s-1THE\s0 \s-1AUTHOR\s0 \s-1DISCLAIMS\s0 \s-1ALL\s0 \s-1WARRANTIES\s0 \s-1WITH\s0 \s-1REGARD\s0 \s-1TO\s0 \s-1THIS\s0 \s-1SOFTWARE\s0, \s-1INCLUDING\s0
\&\s-1ALL\s0 \s-1IMPLIED\s0 \s-1WARRANTIES\s0 \s-1OF\s0 \s-1MERCHANTABILITY\s0 \s-1AND\s0 \s-1FITNESS\s0; \s-1IN\s0 \s-1NO\s0 \s-1EVENT\s0 \s-1SHALL\s0
\&\s-1AUTHOR\s0 \s-1BE\s0 \s-1LIABLE\s0 \s-1FOR\s0 \s-1ANY\s0 \s-1SPECIAL\s0, \s-1INDIRECT\s0 \s-1OR\s0 \s-1CONSEQUENTIAL\s0 \s-1DAMAGES\s0 \s-1OR\s0 \s-1ANY\s0
\&\s-1DAMAGES\s0 \s-1WHATSOEVER\s0 \s-1RESULTING\s0 \s-1FROM\s0 \s-1LOSS\s0 \s-1OF\s0 \s-1USE\s0, \s-1DATA\s0 \s-1OR\s0 \s-1PROFITS\s0, \s-1WHETHER\s0 \s-1IN\s0
\&\s-1AN\s0 \s-1ACTION\s0 \s-1OF\s0 \s-1CONTRACT\s0, \s-1NEGLIGENCE\s0 \s-1OR\s0 \s-1OTHER\s0 \s-1TORTIOUS\s0 \s-1ACTION\s0, \s-1ARISING\s0 \s-1OUT\s0 \s-1OF\s0
\&\s-1OR\s0 \s-1IN\s0 \s-1CONNECTION\s0 \s-1WITH\s0 \s-1THE\s0 \s-1USE\s0 \s-1OR\s0 \s-1PERFORMANCE\s0 \s-1OF\s0 \s-1THIS\s0 \s-1SOFTWARE\s0.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
http://www.net\-dns.org/ <http://www.net-dns.org/>
.PP
\&\fIperl\fR\|(1), Net::DNS, Net::DNS::RR::KEY, Net::DNS::RR::SIG,
Net::DNS::RR::DNSKEY, Net::DNS::RR::RRSIG,
Net::DNS::RR::NSEC, Net::DNS::RR::DS, Net::DNS::SEC::Private.
.PP
\&\s-1RFC4033\s0, 4034 and 4035.