DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

Net::DNS::SEC



NAME

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


SYNOPSIS

use Net::DNS;

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.


DESCRIPTION

The Net::DSN::SEC suite provides the resource records that are needed for DNSSEC (RFC 4033, 4034 and 4035).

It also provides support for SIG0. That later is useful for dynamic updates using key-pairs.

RSA and DSA crypto routines are supported.

For details see the Net::DNS::RR::RRSIG manpage, the Net::DNS::RR::DNSKEY manpage, the Net::DNS::RR::NSEC manpage and the Net::DNS::RR:DS manpage. and see the Net::DNS::RR::SIG manpage and the Net::DNS::RR::KEY manpage for the use with SIG0.

Net::DNS contains all needed hooks to load the Net::DNS::SEC extensions when they are available.

See the Net::DNS manpage for general help.


Utility function

Use the following construct if you want to use thos function in your code.

   use Net::DNS::SEC qw( key_difference );

key_difference

    $result=key_differnece(\@a,\@b,\@result);

Fills @result with all keys in the array ``@a'' that are not in the array ``@b''.

Returns 0 on success or an error message on failure.


Class methods

These functions are inherited by relevant Net::DNS::RR classes. They are not exported.

algorithm

    $value=Net::DNS::SEC->algorithm("RSASHA1");
    $value=$self->algorithm("RSASHA1");
    $value=$self->algorithm(5);
    $algorithm=$self->algorithm();
    $memonic=$self->algorithm("mnemonic");

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.

If supplied with an argument it will set the algorithm accordingly, except when the argument equals the string ``mnemonic'' the method will return the mnemonic of the algorithm.

Can also be called as a class method to do Mnemonic to Value conversion.


COPYRIGHT

Copyright (c) 2001-2005 RIPE NCC. Author Olaf M. Kolkman <olaf@net-dns.org>

All Rights Reserved

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.

THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS; IN NO EVENT SHALL AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

 
=head1 SEE ALSO

http://www.net-dns.org/

perl(1), the Net::DNS manpage, the Net::DNS::RR::KEY manpage, the Net::DNS::RR::SIG manpage, the Net::DNS::RR::DNSKEY manpage, the Net::DNS::RR::RRSIG manpage, the Net::DNS::RR::NSEC manpage, the Net::DNS::RR::DS manpage, the Net::DNS::SEC::Private manpage.

RFC4033, 4034 and 4035.