NAME

       ldns_dnssec_name_new,          ldns_dnssec_name_new_frm_rr,         ldns_dnssec_name_free,
       ldns_dnssec_name_name,        ldns_dnssec_name_set_name,        ldns_dnssec_name_set_nsec,
       ldns_dnssec_name_cmp,         ldns_dnssec_name_add_rr,        ldns_dnssec_name_find_rrset,

       ldns_dnssec_name_print-

SYNOPSIS

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

       #include <ldns/ldns.h>

       ldns_dnssec_name* ldns_dnssec_name_new(void);

       ldns_dnssec_name* ldns_dnssec_name_new_frm_rr(ldns_rr *rr);

       void ldns_dnssec_name_free(ldns_dnssec_name *name);

       ldns_rdf* ldns_dnssec_name_name(ldns_dnssec_name *name);

       void ldns_dnssec_name_set_name(ldns_dnssec_name *name, ldns_rdf *dname);

       void ldns_dnssec_name_set_nsec(ldns_dnssec_name *name, ldns_rr *nsec);

       int ldns_dnssec_name_cmp(const void *a, const void *b);

       ldns_status ldns_dnssec_name_add_rr(ldns_dnssec_name *name, ldns_rr *rr);

       ldns_dnssec_rrsets*   ldns_dnssec_name_find_rrset(ldns_dnssec_name   *name,   ldns_rr_type
       type);

       void ldns_dnssec_name_print(FILE *out, ldns_dnssec_name *name);

DESCRIPTION

       ldns_dnssec_name_new() Create a new data structure for a dnssec name
              Returns the allocated structure

       ldns_dnssec_name_new_frm_rr()  Create a new data structure for a dnssec name for the given
              RR

              rr: the RR to derive properties from, and to add to the name

       ldns_dnssec_name_free() Frees the name structure  and  its  rrs  and  rrsets.   Individual
              ldns_rr records therein are not freed

              name: the structure to free

       ldns_dnssec_name_name() Returns the domain name of the given dnssec_name structure

              name: the dnssec name to get the domain name from
              Returns the domain name

       ldns_dnssec_name_set_name() Sets the domain name of the given dnssec_name structure

              name: the dnssec name to set the domain name of
              dname: the domain name to set it to. This data is *not* copied.

       ldns_dnssec_name_set_nsec() Sets the NSEC(3) RR of the given dnssec_name structure

              name: the dnssec name to set the domain name of
              nsec: the nsec rr to set it to. This data is *not* copied.

       ldns_dnssec_name_cmp()  Compares  the domain names of the two arguments in their canonical
              ordening.

              a: The first dnssec_name to compare
              b: The second dnssec_name to compare
              Returns -1 if the domain name of a comes before that of b in canonical ordening,  1
              if it is the other way around, and 0 if they are equal

       ldns_dnssec_name_add_rr()  Inserts  the  given  rr  at  the  right  place  in  the current
              dnssec_name No checking is done whether the name matches

              name: The ldns_dnssec_name to add the RR to
              rr: The RR to add
              Returns LDNS_STATUS_OK on success, error code otherwise

       ldns_dnssec_name_find_rrset() Find the RRset with the  given  type  in  within  this  name
              structure

              name: the name to find the RRset in
              type: the type of the RRset to find
              Returns the RRset, or NULL if not present

       ldns_dnssec_name_print()  Prints  the  RRs in the  dnssec name structure to the given file
              descriptor

              out: the file descriptor to print to
              name: the name structure to print the contents of

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 MERCHANTABILITY or
       FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       ldns_dnssec_zone.  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.

                                           30 May 2006                                    ldns(3)