NAME

       ldns_wire2rr, ldns_wire2pkt, ldns_wire2rdf, ldns_wire2dname-

SYNOPSIS

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

       #include <ldns/ldns.h>

       ldns_status  ldns_wire2rr(ldns_rr  **rr,  const  uint8_t  *wire,  size_t max, size_t *pos,
       ldns_pkt_section section);

       ldns_status ldns_wire2pkt(ldns_pkt **packet, const uint8_t *data, size_t len);

       ldns_status ldns_wire2rdf(ldns_rr *rr, const uint8_t *wire, size_t max, size_t *pos);

       ldns_status ldns_wire2dname(ldns_rdf **dname, const  uint8_t  *wire,  size_t  max,  size_t
       *pos);

DESCRIPTION

       ldns_wire2rr()  converts  the  data  on  the  uint8_t  bytearray (in wire format) to a DNS
              resource record.  This function will initialize and allocate memory space  for  the
              rr structure.  The length of the wiredata of this rr is added to the *pos value.

              rr: pointer to the structure to hold the rdata value
              wire: pointer to the buffer with the data
              max: the length of the data buffer (in bytes)
              pos:  the  position of the rr in the buffer (ie. the number of bytes from the start
              of the buffer)
              section: the section in the packet the rr is meant for
              Returns LDNS_STATUS_OK if everything succeeds, error otherwise

       ldns_wire2pkt() converts the data on the uint8_t bytearray  (in  wire  format)  to  a  DNS
              packet.   This  function  will  initialize and allocate memory space for the packet
              structure.

              packet: pointer to the structure to hold the packet
              data: pointer to the buffer with the data
              len: the length of the data buffer (in bytes)
              Returns LDNS_STATUS_OK if everything succeeds, error otherwise

       ldns_wire2rdf() converts the data on the uint8_t bytearray (in wire format) to  DNS  rdata
              fields,  and  adds  them  to  the list of rdfs of the given rr.  This function will
              initialize and allocate memory space for the dname structures.  The length  of  the
              wiredata of these rdfs is added to the *pos value.

              All  rdfs belonging to the RR are read; the rr should have no rdfs yet. An error is
              returned if the format cannot be parsed.

              rr: pointer to the ldns_rr structure to hold the rdata value
              wire: pointer to the buffer with the data
              max: the length of the data buffer (in bytes)
              pos: the position of the rdf in the buffer (ie. the number of bytes from the  start
              of the buffer)
              Returns LDNS_STATUS_OK if everything succeeds, error otherwise

       ldns_wire2dname()  converts  the  data  on the uint8_t bytearray (in wire format) to a DNS
              dname rdata field. This function will initialize and allocate memory space for  the
              dname structure. The length of the wiredata of this rdf is added to the *pos value.

              dname: pointer to the structure to hold the rdata value
              wire: pointer to the buffer with the data
              max: the length of the data buffer (in bytes)
              pos:  the position of the rdf in the buffer (ie. the number of bytes from the start
              of the buffer)
              Returns LDNS_STATUS_OK if everything succeeds, error otherwise

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

REMARKS

       This  manpage  was  automaticly  generated from the ldns source code by use of Doxygen and
       some perl.

                                           30 May 2006                                    ldns(3)