.TH ldns 3 "30 May 2006"
.SH 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\-

.SH SYNOPSIS
#include <stdint.h>
.br
#include <stdbool.h>
.br
.PP
#include <ldns/ldns.h>
.PP
ldns_rdf* ldns_rdf_new(ldns_rdf_type type, size_t size, void *data);
.PP
ldns_rdf* ldns_rdf_clone(const ldns_rdf *rd);
.PP
ldns_rdf* ldns_rdf_new_frm_data(ldns_rdf_type type, size_t size, const void *data);
.PP
ldns_rdf* ldns_rdf_new_frm_str(ldns_rdf_type type, const char *str);
.PP
ldns_status ldns_rdf_new_frm_fp(ldns_rdf **r, ldns_rdf_type type, FILE *fp);
.PP
void ldns_rdf_free(ldns_rdf *rd);
.PP
void ldns_rdf_deep_free(ldns_rdf *rd);
.PP
void ldns_rdf_print(FILE *output, const ldns_rdf *rdf);
.PP

.SH DESCRIPTION
.HP
\fIldns_rdf_new\fR()
allocates a new rdf structure and fills it.
This function \%DOES \%NOT copy the contents from
the buffer, unlinke ldns_rdf_new_frm_data()
\.br
\fBtype\fR: type of the rdf
\.br
\fBsize\fR: size of the buffer
\.br
\fBdata\fR: pointer to the buffer to be copied
\.br
Returns the new rdf structure or \%NULL on failure
.PP
.HP
\fIldns_rdf_clone\fR()
clones a rdf structure. The data is copied.
\.br
\fBrd\fR: rdf to be copied
\.br
Returns a new rdf structure
.PP
.HP
\fIldns_rdf_new_frm_data\fR()
allocates a new rdf structure and fills it.
This function _does_ copy the contents from
the buffer, unlinke ldns_rdf_new()
\.br
\fBtype\fR: type of the rdf
\.br
\fBsize\fR: size of the buffer
\.br
\fBdata\fR: pointer to the buffer to be copied
\.br
Returns the new rdf structure or \%NULL on failure
.PP
.HP
\fIldns_rdf_new_frm_str\fR()
creates a new rdf from a string.
\.br
\fBtype\fR: type to use
\.br
\fBstr\fR: string to use
\.br
Returns ldns_rdf* or \%NULL in case of an error
.PP
.HP
\fIldns_rdf_new_frm_fp\fR()
creates a new rdf from a file containing a string.
\.br
\fBr\fR: the new rdf
\.br
\fBtype\fR: type to use
\.br
\fBfp\fR: the file pointer  to use
\.br
Returns \%LDNS_STATUS_OK or the error
.PP
.HP
\fIldns_rdf_free\fR()
frees a rdf structure, leaving the
data pointer intact.
\.br
\fBrd\fR: the pointer to be freed
\.br
Returns void
.PP
.HP
\fIldns_rdf_deep_free\fR()
frees a rdf structure _and_ frees the
data. rdf should be created with _new_frm_data
\.br
\fBrd\fR: the rdf structure to be freed
\.br
Returns void
.PP
.HP
\fIldns_rdf_print\fR()
Prints the data in the rdata field to the given file stream
(in presentation format)

\.br
\fBoutput\fR: the file stream to print to
\.br
\fBrdf\fR: the rdata field to print
\.br
Returns void
.PP
.SH AUTHOR
The ldns team at NLnet Labs. Which consists out of
Jelte Jansen and Miek Gieben.

.SH REPORTING BUGS
Please report bugs to ldns-team@nlnetlabs.nl or in 
our bugzilla at
http://www.nlnetlabs.nl/bugs/index.html

.SH COPYRIGHT
Copyright (c) 2004 - 2006 NLnet Labs.
.PP
Licensed under the BSD License. There is NO warranty; not even for
MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.

.SH SEE ALSO
\fIldns_rdf\fR.
And \fBperldoc Net::DNS\fR, \fBRFC1034\fR,
\fBRFC1035\fR, \fBRFC4033\fR, \fBRFC4034\fR  and \fBRFC4035\fR.
.SH REMARKS
This manpage was automaticly generated from the ldns source code by
use of Doxygen and some perl.