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 - functions for ldns_dnssec_name

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(const 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(const ldns_dnssec_name *name, ldns_rr_type
       type);

       void ldns_dnssec_name_print(FILE *out, const 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 automatically generated from the ldns source code by use of Doxygen and
       some perl.

                                           30 May 2006                                    ldns(3)