NAME

       ldns_rdf_new, ldns_rdf_clone, ldns_rdf_new_frm_data, ldns_rdf_new_frm_str,
       ldns_rdf_new_frm_fp, ldns_rdf_free, ldns_rdf_deep_free, ldns_rdf_print - ldns_rdf
       creation, destruction and printing

SYNOPSIS

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

       #include <ldns/ldns.h>

       ldns_rdf* ldns_rdf_new(ldns_rdf_type type, size_t size, void *data);

       ldns_rdf* ldns_rdf_clone(const ldns_rdf *rd);

       ldns_rdf* ldns_rdf_new_frm_data(ldns_rdf_type type, size_t size, const void *data);

       ldns_rdf* ldns_rdf_new_frm_str(ldns_rdf_type type, const char *str);

       ldns_status ldns_rdf_new_frm_fp(ldns_rdf **r, ldns_rdf_type type, FILE *fp);

       void ldns_rdf_free(ldns_rdf *rd);

       void ldns_rdf_deep_free(ldns_rdf *rd);

       void ldns_rdf_print(FILE *output, const ldns_rdf *rdf);

DESCRIPTION

       ldns_rdf_new() allocates a new rdf structure and fills it.  This function DOES NOT copy
              the contents from the buffer, unlike ldns_rdf_new_frm_data()
              type: type of the rdf
              size: size of the buffer
              data: pointer to the buffer to be copied
              Returns the new rdf structure or NULL on failure

       ldns_rdf_clone() clones a rdf structure. The data is copied.
              rd: rdf to be copied
              Returns a new rdf structure

       ldns_rdf_new_frm_data() allocates a new rdf structure and fills it.  This function _does_
              copy the contents from the buffer, unlike ldns_rdf_new()
              type: type of the rdf
              size: size of the buffer
              data: pointer to the buffer to be copied
              Returns the new rdf structure or NULL on failure

       ldns_rdf_new_frm_str() creates a new rdf from a string.
              type: type to use
              str: string to use
              Returns ldns_rdf* or NULL in case of an error

       ldns_rdf_new_frm_fp() creates a new rdf from a file containing a string.
              r: the new rdf
              type: type to use
              fp: the file pointer  to use
              Returns LDNS_STATUS_OK or the error

       ldns_rdf_free() frees a rdf structure, leaving the data pointer intact.
              rd: the pointer to be freed
              Returns void

       ldns_rdf_deep_free() frees a rdf structure _and_ frees the data. rdf should be created
              with _new_frm_data
              rd: the rdf structure to be freed
              Returns void

       ldns_rdf_print() Prints the data in the rdata field to the given file stream (in
              presentation format)

              output: the file stream to print to
              rdf: the rdata field to print
              Returns void

AUTHOR

       The ldns team at NLnet Labs.

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_rdf.  And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034  and RFC4035.

REMARKS

       This manpage was automatically generated from the ldns source code.

                                           30 May 2006                                    ldns(3)