ldns
Section: C Library Functions (3)
Updated: 30 May 2006
Index
Return to Main Contents
NAME
ldns_dnssec_trust_tree_new, ldns_dnssec_trust_tree_free, ldns_dnssec_trust_tree_depth, ldns_dnssec_derive_trust_tree, ldns_dnssec_trust_tree_contains_keys, ldns_dnssec_trust_tree_print, ldns_dnssec_trust_tree_print_sm, ldns_dnssec_trust_tree_add_parent, ldns_dnssec_derive_trust_tree_normal_rrset, ldns_dnssec_derive_trust_tree_dnskey_rrset, ldns_dnssec_derive_trust_tree_ds_rrset, ldns_dnssec_derive_trust_tree_no_sig - functions for ldns_dnssec_trust_tree
SYNOPSIS
#include <
stdint.h>
#include <
stdbool.h>
#include <ldns/ldns.h>
ldns_dnssec_trust_tree* ldns_dnssec_trust_tree_new(void);
void ldns_dnssec_trust_tree_free(ldns_dnssec_trust_tree *tree);
size_t ldns_dnssec_trust_tree_depth(ldns_dnssec_trust_tree *tree);
ldns_dnssec_trust_tree* ldns_dnssec_derive_trust_tree( ldns_dnssec_data_chain *data_chain, ldns_rr *rr);
ldns_status ldns_dnssec_trust_tree_contains_keys( ldns_dnssec_trust_tree *tree, ldns_rr_list *keys);
void ldns_dnssec_trust_tree_print(FILE *out, ldns_dnssec_trust_tree *tree, size_t tabs, bool extended);
ldns_dnssec_trust_tree_print_sm();
ldns_status ldns_dnssec_trust_tree_add_parent(ldns_dnssec_trust_tree *tree, const ldns_dnssec_trust_tree *parent, const ldns_rr *parent_signature, const ldns_status parent_status);
void ldns_dnssec_derive_trust_tree_normal_rrset( ldns_dnssec_trust_tree *new_tree, ldns_dnssec_data_chain *data_chain, ldns_rr *cur_sig_rr);
void ldns_dnssec_derive_trust_tree_dnskey_rrset( ldns_dnssec_trust_tree *new_tree, ldns_dnssec_data_chain *data_chain, ldns_rr *cur_rr, ldns_rr *cur_sig_rr);
void ldns_dnssec_derive_trust_tree_ds_rrset( ldns_dnssec_trust_tree *new_tree, ldns_dnssec_data_chain *data_chain, ldns_rr *cur_rr);
void ldns_dnssec_derive_trust_tree_no_sig( ldns_dnssec_trust_tree *new_tree, ldns_dnssec_data_chain *data_chain);
DESCRIPTION
-
ldns_dnssec_trust_tree_new()
- Creates a new (empty) dnssec_trust_tree structure
.br
Returns ldns_dnssec_trust_tree *
-
ldns_dnssec_trust_tree_free()
- Frees the dnssec_trust_tree recursively
There is no deep free; all data in the trust tree
consists of pointers to a data_chain
.br
tree: The tree to free
-
ldns_dnssec_trust_tree_depth()
- returns the depth of the trust tree
.br
tree: tree to calculate the depth of
.br
Returns The depth of the tree
-
ldns_dnssec_derive_trust_tree()
- Generates a dnssec_trust_tree for the given rr from the
given data_chain
This does not clone the actual data; Don't free the
data_chain before you are done with this tree
.br
*data_chain: The chain to derive the trust tree from
.br
*rr: The RR this tree will be about
.br
Returns ldns_dnssec_trust_tree *
-
ldns_dnssec_trust_tree_contains_keys()
- Returns OK if there is a trusted path in the tree to one of
the DNSKEY or DS RRs in the given list
param *tree The trust tree so search
param *keys A ldns_rr_list of DNSKEY and DS rrs to look for
.br
Returns LDNS_STATUS_OK if there is a trusted path to one of
the keys, or the *first* error encountered
if there were no paths
-
ldns_dnssec_trust_tree_print()
- Prints the dnssec_trust_tree structure to the given file
stream.
If a link status is not LDNS_STATUS_OK; the status and
relevant signatures are printed too
.br
*out: The file stream to print to
.br
tree: The trust tree to print
.br
tabs: Prepend each line with tabs*2 spaces
.br
extended: If true, add little explanation lines to the output
-
ldns_dnssec_trust_tree_print_sm()
-
ldns_dnssec_trust_tree_add_parent()
- Adds a trust tree as a parent for the given trust tree
.br
*tree: The tree to add the parent to
.br
*parent: The parent tree to add
.br
*parent_signature: The RRSIG relevant to this parent/child
connection
.br
parent_status: The DNSSEC status for this parent, child and RRSIG
.br
Returns LDNS_STATUS_OK if the addition succeeds, error otherwise
-
ldns_dnssec_derive_trust_tree_normal_rrset()
- Sub function for derive_trust_tree that is used for a 'normal' rrset
.br
new_tree: The trust tree that we are building
.br
data_chain: The data chain containing the data for the trust tree
.br
cur_sig_rr: The currently relevant signature
-
ldns_dnssec_derive_trust_tree_dnskey_rrset()
- Sub function for derive_trust_tree that is used for DNSKEY rrsets
.br
new_tree: The trust tree that we are building
.br
data_chain: The data chain containing the data for the trust tree
.br
cur_rr: The currently relevant DNSKEY RR
.br
cur_sig_rr: The currently relevant signature
-
ldns_dnssec_derive_trust_tree_ds_rrset()
- Sub function for derive_trust_tree that is used for DS rrsets
.br
new_tree: The trust tree that we are building
.br
data_chain: The data chain containing the data for the trust tree
.br
cur_rr: The currently relevant DS RR
-
ldns_dnssec_derive_trust_tree_no_sig()
- Sub function for derive_trust_tree that is used when there are no
signatures
.br
new_tree: The trust tree that we are building
.br
data_chain: The data chain containing the data for the trust tree
AUTHOR
The ldns team at NLnet Labs.
REPORTING BUGS
Please report bugs to
ldn-team@nlnetlabs.nl or in
our bugzilla at
http://www.nlnetlabs.nl/bugs/index.html
COPYRIGHT
Copyright (c) 2004- 2006 NLnet Labs.
Licensed under the BSD License. There is NO warranty; not even for
MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO
ldns_dnssec_data_chain,
ldns_dnssec_trust_tree.
And
perldoc Net::DNS,
RFC1034,
RFC1035,
RFC4033,
RFC4034 and
RFC4035.
REMARKS
This manpage was automatically generated from the ldns source code.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- AUTHOR
-
- REPORTING BUGS
-
- COPYRIGHT
-
- SEE ALSO
-
- REMARKS
-