ldns_verify(3)

ldns_verify3

Verify rrsigs

Usage

#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(const ldns_rr_list *rrset, const 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);

Overview

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

.br rrset: the rrset to verify .br rrsig: a list of signatures to check .br keys: a list of keys to check with .br good_keys: 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

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

ldns_verify_rrsig_keylist() Verifies an rrsig. All keys in the keyset are tried. .br rrset: the rrset to check .br rrsig: the signature of the rrset .br keys: the keys to try .br good_keys: if this is a (initialized) list, the pointer to keys from keys that validate one of the signatures are added to it .br 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. .br rrset: the rrset to check .br rrsig: the signature of the rrset .br keys: the keys to try .br good_keys: if this is a (initialized) list, the pointer to keys from keys that validate one of the signatures are added to it .br 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.

.br rrset: the rrset to verify .br rrsig: a list of signatures to check .br keys: a list of keys to check with .br good_keys: 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

Remarks

This manpage was automatically generated from the ldns source code.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 5 times.

  1. 5.0
  2. 6.0–7
  3. 8
  4. 9–10
  5. 11–12
  6. 13–Arch

Author

The ldns team at NLnet Labs.

Reporting bugs

Please report bugs to [email protected] or on GitHub at https://github.com/NLnetLabs/ldns/issues

From ldns 1.9.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.