ldns(3) Library Functions Manual ldns(3)

NAME
       ldnsbuffernew, ldnsbuffernewfrmdata, ldnsbufferclear, ldnsbuf‐
       ferprintf, ldnsbufferfree, ldnsbufferexport


SYNOPSIS
       #include 
       #include 

       #include 

       ldnsbuffer* ldnsbuffernew(sizet capacity);

       void ldnsbuffernewfrmdata(ldnsbuffer *buffer, void  *data,  sizet
       size);

       void ldnsbufferclear(ldnsbuffer *buffer);

       int ldnsbufferprintf(ldnsbuffer *buffer, const char *format, ...);

       void ldnsbufferfree(ldnsbuffer *buffer);

       void* ldnsbufferexport(ldnsbuffer *buffer);

DESCRIPTION
       ldnsbuffernew() creates a new buffer with the specified capacity.

              capacity: the size (in bytes) to allocate for the buffer
              Returns the created buffer

       ldnsbuffernewfrmdata()  creates  a  buffer with the specified data.
              The data IS copied and MEMORY allocations are done.  The  buffer
              is not fixed and can be resized using bufferreserve().

              buffer: pointer to the buffer to put the data in
              data: the data to encapsulate in the buffer
              size: the size of the data

       ldnsbufferclear()  clears  the  buffer and make it ready for writing.
              The buffer's limit is set to the capacity and  the  position  is
              set to 0.
              buffer: the buffer to clear

       ldnsbufferprintf()  prints  to the buffer, increasing the capacity if
              required using bufferreserve(). The buffer's position is set to
              the  terminating  '\\0' Returns the number of characters written
              (not including the terminating '\\0') or -1 on failure.

       ldnsbufferfree() frees the buffer.
              *buffer: the buffer to be freed
              Returns void

       ldnsbufferexport() Makes the buffer fixed and returns  a  pointer  to
              the data.  The caller is responsible for free'ing the result.
              *buffer: the buffer to be exported
              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 MER‐
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


SEE ALSO
       ldnsbuffer.  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)