.TH ldns 3 "30 May 2006"
.SH NAME
ldns_calc_keytag, ldns_verify, ldns_verify_rrsig, ldns_verify_rrsig_dsa, ldns_verify_rrsig_rsasha1, ldns_verify_rrsig_rsamd5, ldns_key_rr2ds, ldns_key_buf2dsa, ldns_key_buf2rsa\-

.SH SYNOPSIS
#include <stdint.h>
.br
#include <stdbool.h>
.br
.PP
#include <ldns/ldns.h>
.PP
uint16_t ldns_calc_keytag(const ldns_rr *key);
.PP
ldns_status ldns_verify(ldns_rr_list *rrset, ldns_rr_list *rrsig, const ldns_rr_list *keys, ldns_rr_list *good_keys);
.PP
ldns_status ldns_verify_rrsig(ldns_rr_list *rrset, ldns_rr *rrsig, ldns_rr *key);
.PP
ldns_status ldns_verify_rrsig_dsa(ldns_buffer *sig, ldns_buffer *rrset, ldns_buffer *key);
.PP
ldns_status ldns_verify_rrsig_rsasha1(ldns_buffer *sig, ldns_buffer *rrset, ldns_buffer *key);
.PP
ldns_status ldns_verify_rrsig_rsamd5(ldns_buffer *sig, ldns_buffer *rrset, ldns_buffer *key);
.PP
ldns_rr* ldns_key_rr2ds(const ldns_rr *key, ldns_hash h);
.PP
DSA* ldns_key_buf2dsa(ldns_buffer *key);
.PP
RSA* ldns_key_buf2rsa(ldns_buffer *key);
.PP

.SH DESCRIPTION
.HP
\fIldns_calc_keytag\fR()
calculates a keytag of a key for use in \%DNSSEC.

\.br
\fBkey\fR: the key as an \%RR to use for the calc.
\.br
Returns the keytag
.PP
.HP
\fIldns_verify\fR()
Verifies a list of signatures for one rrset.

\.br
\fBrrset\fR: the rrset to verify
\.br
\fBrrsig\fR: a list of signatures to check
\.br
\fBkeys\fR: a list of keys to check with
\.br
\fBgood_keys\fR: if this is a (initialized) list, the pointer to keys
from keys that validate one of the signatures
are added to it
\.br
Returns status \%LDNS_STATUS_OK if there is at least one correct key
.PP
.HP
\fIldns_verify_rrsig\fR()
verify an rrsig with 1 key
\.br
\fBrrset\fR: the rrset
\.br
\fBrrsig\fR: the rrsig to verify
\.br
\fBkey\fR: the key to use
\.br
Returns status message wether verification succeeded.
.PP
.HP
\fIldns_verify_rrsig_dsa\fR()
verifies a buffer with signature data (\%DSA) for a buffer with rrset data 
with a buffer with key data.

\.br
\fBsig\fR: the signature data
\.br
\fBrrset\fR: the rrset data, sorted and processed for verification
\.br
\fBkey\fR: the key data
.PP
.HP
\fIldns_verify_rrsig_rsasha1\fR()
verifies a buffer with signature data (RSASHA1) for a buffer with rrset data 
with a buffer with key data.

\.br
\fBsig\fR: the signature data
\.br
\fBrrset\fR: the rrset data, sorted and processed for verification
\.br
\fBkey\fR: the key data
.PP
.HP
\fIldns_verify_rrsig_rsamd5\fR()
verifies a buffer with signature data (RSAMD5) for a buffer with rrset data 
with a buffer with key data.

\.br
\fBsig\fR: the signature data
\.br
\fBrrset\fR: the rrset data, sorted and processed for verification
\.br
\fBkey\fR: the key data
.PP
.HP
\fIldns_key_rr2ds\fR()
returns a new \%DS rr that represents the given key rr.

\.br
\fB*key\fR: the key to convert
\.br
\fBh\fR: the hash to use LDNS_SHA1/LDNS_SHA256

\.br
Returns ldns_rr* a new rr pointer to a \%DS
.PP
.HP
\fIldns_key_buf2dsa\fR()
converts a buffer holding key material to a \%DSA key in openssl.

\.br
\fBkey\fR: the key to convert
\.br
Returns a \%DSA * structure with the key material
.PP
.HP
\fIldns_key_buf2rsa\fR()
converts a buffer holding key material to a \%RSA key in openssl.

\.br
\fBkey\fR: the key to convert
\.br
Returns a \%RSA * structure with the key material
.PP
.SH AUTHOR
The ldns team at NLnet Labs. Which consists out of
Jelte Jansen and Miek Gieben.

.SH REPORTING BUGS
Please report bugs to ldns-team@nlnetlabs.nl or in 
our bugzilla at
http://www.nlnetlabs.nl/bugs/index.html

.SH COPYRIGHT
Copyright (c) 2004 - 2006 NLnet Labs.
.PP
Licensed under the BSD License. There is NO warranty; not even for
MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.

.SH SEE ALSO
\fIldns_key\fR, \fIldns_sign_public\fR, \fIldns_zone_sign\fR, \fIldns_verify\fR, \fIldns_verify_rrsig\fR.
And \fBperldoc Net::DNS\fR, \fBRFC1034\fR,
\fBRFC1035\fR, \fBRFC4033\fR, \fBRFC4034\fR  and \fBRFC4035\fR.
.SH REMARKS
This manpage was automaticly generated from the ldns source code by
use of Doxygen and some perl.