manpagez: man pages & more
man ldns_dnssec_trust_tree_free(3)
Home | html | info | man
ldns(3)                                                                ldns(3)




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



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_sig-
       nature, 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

              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

              tree: The tree to free


       ldns_dnssec_trust_tree_depth() returns the depth of the trust tree

              tree: tree to calculate the depth of
              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

              *data_chain: The chain to derive the trust tree from
              *rr: The RR this tree will be about
              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

              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

              *out: The file stream to print to
              tree: The trust tree to print
              tabs: Prepend each line with tabs*2 spaces
              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

              *tree: The tree to add the parent to
              *parent: The parent tree to add
              *parent_signature:  The RRSIG relevant to this parent/child con-
              nection
              parent_status: The DNSSEC status  for  this  parent,  child  and
              RRSIG
              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

              new_tree: The trust tree that we are building
              data_chain:  The  data  chain  containing the data for the trust
              tree
              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

              new_tree: The trust tree that we are building
              data_chain:  The  data  chain  containing the data for the trust
              tree
              cur_rr: The currently relevant DNSKEY RR
              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

              new_tree: The trust tree that we are building
              data_chain:  The  data  chain  containing the data for the trust
              tree
              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

              new_tree: The trust tree that we are building
              data_chain:  The  data  chain  containing the data for the trust
              tree



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



COPYRIGHT

       Copyright (c) 2004 - 2006 NLnet Labs.

       Licensed under the BSD License. There is NO warranty; not even for MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.



SEE ALSO

       ldns_dnssec_data_chain(3), ldns_dnssec_trust_tree(3). And perldoc
       Net::DNS(3), RFC1034, RFC1035, RFC4033, RFC4034  and RFC4035.


REMARKS

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



                                  30 May 2006                          ldns(3)

ldns 1.6.17 - Generated Sun Feb 2 16:18:02 CST 2014
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.