Net::DNS::SEC(3pm)

1SEC(3)                User Contributed Perl Documentation               SEC(3)
2
3
4

NAME

6       Net::DNS::SEC - DNSSEC extensions to Net::DNS
7

SYNOPSIS

9       "use Net::DNS;"
10
11       The Net::DNS::SEC module implements a few class methods used by the
12       other modules in this suite and a few functions that can be exported.
13

DESCRIPTION

15       The Net::DSN::SEC suite provides the resource records that are needed
16       for DNSSEC (RFC 4033, 4034 and 4035). In addition the DLV RR, a clone
17       of the DS RR is supported (RFC 4431)
18
19       It also provides support for SIG0. That later is useful for dynamic
20       updates using key-pairs.
21
22       RSA and DSA crypto routines are supported.
23
24       For details see Net::DNS::RR::RRSIG, Net::DNS::RR::DNSKEY,
25       Net::DNS::RR::NSEC, Net::DNS::RR:DS, Net::DNS::RR::DLV, and see
26       Net::DNS::RR::SIG and Net::DNS::RR::KEY for the use with SIG0.
27
28       Net::DNS contains all needed hooks to load the Net::DNS::SEC extensions
29       when they are available.
30
31       See Net::DNS for general help.
32

Utility function

34       Use the following construct if you want to use thos function in your
35       code.
36
37          use Net::DNS::SEC qw( key_difference );
38
39   key_difference
40           $result=key_differnece(\@a,\@b,\@result);
41
42       Fills @result with all keys in the array "@a" that are not in the array
43       "@b".
44
45       Returns 0 on success or an error message on failure.
46

Class methods

48       These functions are inherited by relevant Net::DNS::RR classes. They
49       are not exported.
50
51   algorithm
52           $value=Net::DNS::SEC->algorithm("RSASHA1");
53           $value=$self->algorithm("RSASHA1");
54           $value=$self->algorithm(5);
55
56           $algorithm=$self->algorithm();
57           $memonic=$self->algorithm("mnemonic");
58
59       The algorithm method is used to set or read the value of the algorithm
60       field in Net::DNS::RR::DNSKEY and Net::DNS::RR::RRSIG.
61
62       If supplied with an argument it will set the algorithm accordingly,
63       except when the argument equals the string "mnemonic" the method will
64       return the mnemonic of the algorithm.
65
66       Can also be called as a class method to do Mnemonic to Value
67       conversion.
68
69   digtype
70           $value=$self->digtype("SHA1");
71           $value=$self->digtype(1);
72
73           $algorithm=$self->digtype();
74           $memonic=$self->digtype("mnemonic");
75
76       The algorithm method is used to set or read the value of the digest or
77       hash algorithm field in Net::DNS::RR::DS and Net::DNS::RR::NSEC3
78       objects.
79
80       If supplied with an argument it will set the digetstype/hash algorithm
81       accordingly, except when the argument equals the string "mnemonic" the
82       method will return the mnemonic of the digetstype/hash algorithm.
83
84       Can also be called as a class method to do Mnemonic to Value
85       conversion, note however that it will then use the "Delegation Signer
86       (DS) Resource Record (RR) Type Digest Algorithms" and not the "DNSSEC
87       NSEC3 Hash Algorithms" IANA registry. If you want to specifically get
88       access to the NSEC3  digest types then use a construct like:
89
90        bless $self, Net::DNS::RR::NSEC3;
91        $self->digtype("SHA1");
92

COPYRIGHT

94       Copyright (c) 2001-2005  RIPE NCC.  Author Olaf M. Kolkman
95       <olaf@net-dns.org>
96
97       All Rights Reserved
98
99       Permission to use, copy, modify, and distribute this software and its
100       documentation for any purpose and without fee is hereby granted,
101       provided that the above copyright notice appear in all copies and that
102       both that copyright notice and this permission notice appear in
103       supporting documentation, and that the name of the author not be used
104       in advertising or publicity pertaining to distribution of the software
105       without specific, written prior permission.
106
107       THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
108       INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS; IN NO
109       EVENT SHALL AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
110       DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
111       PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
112       ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
113       THIS SOFTWARE.
114

NAME

SYNOPSIS

DESCRIPTION

Utility function

Class methods

COPYRIGHT

SEE ALSO