1ldns(3)                    Library Functions Manual                    ldns(3)
2
3
4

NAME

6       ldns_pkt2buffer_str,   ldns_pktheader2buffer_str,   ldns_rr2buffer_str,
7       ldns_rr_list2buffer_str,   ldns_rdf2buffer_str,    ldns_key2buffer_str,
8       ldns_pkt2buffer_wire,     ldns_rr2buffer_wire,    ldns_rdf2buffer_wire,
9       ldns_rrsig2buffer_wire, ldns_rr_rdata2buffer_wire
10
11

SYNOPSIS

13       #include <stdint.h>
14       #include <stdbool.h>
15
16       #include <ldns/ldns.h>
17
18       ldns_status  ldns_pkt2buffer_str(ldns_buffer  *output,  const  ldns_pkt
19       *pkt);
20
21       ldns_status    ldns_pktheader2buffer_str(ldns_buffer   *output,   const
22       ldns_pkt *pkt);
23
24       ldns_status ldns_rr2buffer_str(ldns_buffer *output, const ldns_rr *rr);
25
26       ldns_status    ldns_rr_list2buffer_str(ldns_buffer    *output,    const
27       ldns_rr_list *list);
28
29       ldns_status  ldns_rdf2buffer_str(ldns_buffer  *output,  const  ldns_rdf
30       *rdf);
31
32       ldns_status  ldns_key2buffer_str(ldns_buffer  *output,  const  ldns_key
33       *k);
34
35       ldns_status  ldns_pkt2buffer_wire(ldns_buffer  *output,  const ldns_pkt
36       *pkt);
37
38       ldns_status ldns_rr2buffer_wire(ldns_buffer *output, const ldns_rr *rr,
39       int section);
40
41       ldns_status  ldns_rdf2buffer_wire(ldns_buffer  *output,  const ldns_rdf
42       *rdf);
43
44       ldns_status ldns_rrsig2buffer_wire(ldns_buffer *output,  const  ldns_rr
45       *sigrr);
46
47       ldns_status    ldns_rr_rdata2buffer_wire(ldns_buffer   *output,   const
48       ldns_rr *rr);
49

DESCRIPTION

51       ldns_pkt2buffer_str() Converts the data in the DNS packet to  presenta‐
52              tion format (as char *) and appends it to the given buffer
53
54              output: pointer to the buffer to append the data to
55              pkt: the pointer to the packet to convert
56              Returns status
57
58       ldns_pktheader2buffer_str()  Converts the header of a packet to presen‐
59              tation format and appends it to the output buffer
60              output: the buffer to append output to
61              pkt: the packet to convert the header of
62              Returns ldns_status
63
64       ldns_rr2buffer_str() Converts the data in the resource record  to  pre‐
65              sentation format (as char *) and appends it to the given buffer.
66              The presentation format of DNSKEY record is annotated with  com‐
67              ments giving the id, type and size of the key.
68
69              output: pointer to the buffer to append the data to
70              rr: the pointer to the rr field to convert
71              Returns status
72
73       ldns_rr_list2buffer_str() Converts a rr_list to presentation format and
74              appends it to the output buffer
75              output: the buffer to append output to
76              list: the ldns_rr_list to print
77              Returns ldns_status
78
79       ldns_rdf2buffer_str() Converts the data in the rdata field to presenta‐
80              tion format (as char *) and appends it to the given buffer
81
82              output: pointer to the buffer to append the data to
83              rdf: the pointer to the rdafa field containing the data
84              Returns status
85
86       ldns_key2buffer_str()  Converts the data in the DNS packet to presenta‐
87              tion format (as char *) and appends it to the given buffer
88
89              output: pointer to the buffer to append the data to
90              k: the pointer to the private key to convert
91              Returns status
92
93       ldns_pkt2buffer_wire() Copies the packet data to  the  buffer  in  wire
94              format
95              *output: buffer to append the result to
96              *pkt: packet to convert
97              Returns ldns_status
98
99       ldns_rr2buffer_wire() Copies the rr data to the buffer in wire format
100              *output: buffer to append the result to
101              *rr: resource record to convert
102              section: the section in the packet this rr is supposed to be in
103                         (to determine whether to add rdata or not)
104              Returns ldns_status
105
106       ldns_rdf2buffer_wire() Copies the rdata data to the buffer in wire for‐
107              mat
108              *output: buffer to append the result to
109              *rdf: rdata to convert
110              Returns ldns_status
111
112       ldns_rrsig2buffer_wire() Converts a rrsig to wireformat BUT EXCLUDE the
113              rrsig rdata This is needed in DNSSEC verification
114              output: buffer to append the result to
115              sigrr: signature rr to operate on
116              Returns ldns_status
117
118       ldns_rr_rdata2buffer_wire() Converts an rr's rdata to wireformat, while
119              excluding the ownername and all  the  stuff  before  the  rdata.
120              This  is needed in DNSSEC keytag calculation, the ds calcalution
121              from the key and maybe elsewhere.
122
123              *output: buffer where to put the result
124              *rr: rr to operate on
125              Returns ldns_status
126

AUTHOR

128       The ldns team at NLnet Labs. Which consists out  of  Jelte  Jansen  and
129       Miek Gieben.
130
131

REPORTING BUGS

133       Please  report  bugs  to  ldns-team@nlnetlabs.nl  or in our bugzilla at
134       http://www.nlnetlabs.nl/bugs/index.html
135
136
138       Copyright (c) 2004 - 2006 NLnet Labs.
139
140       Licensed under the BSD License. There is NO warranty; not even for MER‐
141       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
142
143

SEE ALSO

145       ldns_pkt2str,      ldns_rr2str,     ldns_rdf2str,     ldns_rr_list2str,
146       ldns_key2str.  And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034
147       and RFC4035.
148

REMARKS

150       This manpage was automaticly generated from the ldns source code by use
151       of Doxygen and some perl.
152
153
154
155                                  30 May 2006                          ldns(3)
Impressum