ldns_verify man page

ldns_verify, ldns_verify_rrsig, ldns_verify_rrsig_keylist, ldns_verify_rrsig_keylist_notime, ldns_verify_notime

Synopsis

#include <stdint.h>
#include <stdbool.h>

#include <ldns/ldns.h>

ldns_status ldns_verify(ldns_rr_list *rrset, ldns_rr_list *rrsig, const ldns_rr_list *keys, ldns_rr_list *good_keys);

ldns_status ldns_verify_rrsig(ldns_rr_list *rrset, ldns_rr *rrsig, ldns_rr *key);

ldns_status ldns_verify_rrsig_keylist(ldns_rr_list *rrset, ldns_rr *rrsig, const ldns_rr_list *keys, ldns_rr_list *good_keys);

ldns_status ldns_verify_rrsig_keylist_notime(ldns_rr_list *rrset, ldns_rr *rrsig, const ldns_rr_list *keys, ldns_rr_list *good_keys);

ldns_status ldns_verify_notime(ldns_rr_list *rrset, ldns_rr_list *rrsig, const ldns_rr_list *keys, ldns_rr_list *good_keys);

Description

ldns_verify() Verifies a list of signatures for one rrset.

rrset: the rrset to verify
rrsig: a list of signatures to check
keys: a list of keys to check with
good_keys: if this is a (initialized) list, the pointer to keys from keys that validate one of the signatures are added to it
Returns status LDNS_STATUS_OK if there is at least one correct key

ldns_verify_rrsig() verify an rrsig with 1 key
rrset: the rrset
rrsig: the rrsig to verify
key: the key to use
Returns status message wether verification succeeded.

ldns_verify_rrsig_keylist() Verifies an rrsig. All keys in the keyset are tried.
rrset: the rrset to check
rrsig: the signature of the rrset
keys: the keys to try
good_keys: if this is a (initialized) list, the pointer to keys from keys that validate one of the signatures are added to it
Returns a list of keys which validate the rrsig + rrset. Returns status LDNS_STATUS_OK if at least one key matched. Else an error.

ldns_verify_rrsig_keylist_notime() Verifies an rrsig. All keys in the keyset are tried. Time is not checked.
rrset: the rrset to check
rrsig: the signature of the rrset
keys: the keys to try
good_keys: if this is a (initialized) list, the pointer to keys from keys that validate one of the signatures are added to it
Returns a list of keys which validate the rrsig + rrset. Returns status LDNS_STATUS_OK if at least one key matched. Else an error.

ldns_verify_notime() Verifies a list of signatures for one rrset, but disregard the time. Inception and Expiration are not checked.

rrset: the rrset to verify
rrsig: a list of signatures to check
keys: a list of keys to check with
good_keys: if this is a (initialized) list, the pointer to keys from keys that validate one of the signatures are added to it
Returns status LDNS_STATUS_OK if there is at least one correct key

Author

The ldns team at NLnet Labs. Which consists out of Jelte Jansen and Miek Gieben.

Reporting Bugs

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

See Also

ldns_verify_rrsig_evp. And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034 and RFC4035.

Remarks

This manpage was automaticly generated from the ldns source code by use of Doxygen and some perl.

Referenced By

ldns_calc_keytag(3), ldns_key_buf2dsa(3), ldns_key_buf2rsa(3), ldns_verify_notime(3), ldns_verify_rrsig(3), ldns_verify_rrsig_keylist(3) and ldns_verify_rrsig_keylist_notime(3) are aliases of ldns_verify(3).

30 May 2006