The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
Net-DNS-SEC-0.04
River stage zero No dependents
/ Net::DNS::RR::DS

NAME

Net::DNS::RR::DS - DNS DS resource record

SYNOPSIS

use Net::DNS::RR;

DESCRIPTION

Class for Delegation signer (DS) resource records.

METHODS

In addition to the regular methods

create

This constructor takes a key object as argument and will return a DS RR object.

$dsrr=create Net::DNS::RR::DS($keyrr); $keyrr->print; $dsrr->print;

verify

The verify method will return 1 if the hash over the key provided in the argument matches the data in the $dsrr itself i.e. if the DS pointing to the KEY from the argument. It will return 0 otherwise.

$dsrr->($keyrr);

algorithm

    print "algoritm" = ", $rr->algorithm, "\n";

Returns the RR's algorithm field in decimal representation

    1 = MD5 RSA
    2 = DH
    3 = DSA
    4 = Elliptic curve

digest

    print "digest" = ", $dsrr->digest, "\n";

Returns the SHA1 digest over the label and key in hexadecimal representation

digestbin

    $digestbin =  $dsrr->digestbin;

Returns the digest as binary material

keytag

    print "keytag" = ", $dsrr->keytag, "\n";

Returns the key tag of the key. (RFC2535 4.1.6)

TODO

This is an implementation of draft-ietf-dnsext-delegation-signer-0.7.txt. In Net::DNS.pm the QTYPE assigned to this RR is 42. Note that IANA has not assigned a QTYPE yet.

When using this code with other implementations of DS you may want to verify this the QTYPE value.

COPYRIGHT

Copyright (c) 2001 RIPE NCC. Author Olaf M. Kolkman <net-dns-sec@ripe.net>

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.

Based on, and contains, code by Copyright (c) 1997 Michael Fuhr.

SEE ALSO

perl(1), Net::DNS, Net::DNS::Resolver, Net::DNS::Packet, Net::DNS::Header, Net::DNS::Question, Net::DNS::RR, draft-ietf-dnssext-delegation-signer