Scroll to navigation

ldns(3) Library Functions Manual ldns(3)

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, unlinke 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, unlinke 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. 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_rdf. 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