.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres.3,v 1.15.2.3 2005/05/12 23:55:49 sra Exp $
+.\" $Id: lwres.3,v 1.15.2.4 2005/09/12 00:29:02 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres \- introduction to the lightweight resolver library
.SH "SYNOPSIS"
+.nf
#include <lwres/lwres\&.h>
-.sp
+.fi
.SH "DESCRIPTION"
.PP
The BIND 9 lightweight resolver library is a simple, name service independent stub resolver library\&. It provides hostname\-to\-address and address\-to\-hostname lookup services to applications by transmitting lookup requests to a resolver daemon \fBlwresd\fR running on the local host\&. The resover daemon performs the lookup using the DNS or possibly other name service protocols, and returns the results to the application through the library\&. The library and resolver daemon communicate using a simple UDP\-based protocol\&.
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_buffer.3,v 1.12.2.4 2005/05/12 23:55:49 sra Exp $
+.\" $Id: lwres_buffer.3,v 1.12.2.5 2005/09/12 00:29:03 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_buffer_init, lwres_buffer_invalidate, lwres_buffer_add, lwres_buffer_subtract, lwres_buffer_clear, lwres_buffer_first, lwres_buffer_forward, lwres_buffer_back, lwres_buffer_getuint8, lwres_buffer_putuint8, lwres_buffer_getuint16, lwres_buffer_putuint16, lwres_buffer_getuint32, lwres_buffer_putuint32, lwres_buffer_putmem, lwres_buffer_getmem \- lightweight resolver buffer management
.SH "SYNOPSIS"
+.nf
#include <lwres/lwbuffer\&.h>
-.sp
+.fi
.HP 24
void\ \fBlwres_buffer_init\fR\ (lwres_buffer_t\ *b, void\ *base, unsigned\ int\ length);
.HP 30
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_config.3,v 1.12.2.4 2005/05/12 23:55:50 sra Exp $
+.\" $Id: lwres_config.3,v 1.12.2.5 2005/09/12 00:29:03 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get \- lightweight resolver configuration
.SH "SYNOPSIS"
+.nf
#include <lwres/lwres\&.h>
-.sp
+.fi
.HP 22
void\ \fBlwres_conf_init\fR\ (lwres_context_t\ *ctx);
.HP 23
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_context.3,v 1.13.2.5 2005/05/12 23:55:50 sra Exp $
+.\" $Id: lwres_context.3,v 1.13.2.6 2005/09/12 00:29:04 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_context_create, lwres_context_destroy, lwres_context_nextserial, lwres_context_initserial, lwres_context_freemem, lwres_context_allocmem, lwres_context_sendrecv \- lightweight resolver context management
.SH "SYNOPSIS"
+.nf
#include <lwres/lwres\&.h>
-.sp
+.fi
.HP 37
lwres_result_t\ \fBlwres_context_create\fR\ (lwres_context_t\ **contextp, void\ *arg, lwres_malloc_t\ malloc_function, lwres_free_t\ free_function);
.HP 38
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_gabn.3,v 1.13.2.4 2005/05/12 23:55:51 sra Exp $
+.\" $Id: lwres_gabn.3,v 1.13.2.5 2005/09/12 00:29:05 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_gabnrequest_render, lwres_gabnresponse_render, lwres_gabnrequest_parse, lwres_gabnresponse_parse, lwres_gabnresponse_free, lwres_gabnrequest_free \- lightweight resolver getaddrbyname message handling
.SH "SYNOPSIS"
+.nf
#include <lwres/lwres\&.h>
-.sp
+.fi
.HP 41
lwres_result_t\ \fBlwres_gabnrequest_render\fR\ (lwres_context_t\ *ctx, lwres_gabnrequest_t\ *req, lwres_lwpacket_t\ *pkt, lwres_buffer_t\ *b);
.HP 42
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_gai_strerror.3,v 1.13.2.4 2005/05/12 23:55:51 sra Exp $
+.\" $Id: lwres_gai_strerror.3,v 1.13.2.5 2005/09/12 00:29:00 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
gai_strerror \- print suitable error string
.SH "SYNOPSIS"
+.nf
#include <lwres/netdb\&.h>
-.sp
+.fi
.HP 22
char\ *\ \fBgai_strerror\fR\ (int\ ecode);
.SH "DESCRIPTION"
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_getaddrinfo.3,v 1.16.2.5 2005/05/12 23:55:52 sra Exp $
+.\" $Id: lwres_getaddrinfo.3,v 1.16.2.6 2005/09/12 00:29:01 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_getaddrinfo, lwres_freeaddrinfo \- socket address structure to host and service name
.SH "SYNOPSIS"
+.nf
#include <lwres/netdb\&.h>
-.sp
+.fi
.HP 23
int\ \fBlwres_getaddrinfo\fR\ (const\ char\ *hostname, const\ char\ *servname, const\ struct\ addrinfo\ *hints, struct\ addrinfo\ **res);
.HP 25
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_gethostent.3,v 1.16.2.4 2005/05/13 02:24:57 marka Exp $
+.\" $Id: lwres_gethostent.3,v 1.16.2.5 2005/09/12 00:29:01 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_gethostbyname, lwres_gethostbyname2, lwres_gethostbyaddr, lwres_gethostent, lwres_sethostent, lwres_endhostent, lwres_gethostbyname_r, lwres_gethostbyaddr_r, lwres_gethostent_r, lwres_sethostent_r, lwres_endhostent_r \- lightweight resolver get network host entry
.SH "SYNOPSIS"
+.nf
#include <lwres/netdb\&.h>
-.sp
+.fi
.HP 40
struct\ hostent\ *\ \fBlwres_gethostbyname\fR\ (const\ char\ *name);
.HP 41
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_getipnode.3,v 1.13.2.5 2005/05/12 23:55:53 sra Exp $
+.\" $Id: lwres_getipnode.3,v 1.13.2.6 2005/09/12 00:29:02 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_getipnodebyname, lwres_getipnodebyaddr, lwres_freehostent \- lightweight resolver nodename / address translation API
.SH "SYNOPSIS"
+.nf
#include <lwres/netdb\&.h>
-.sp
+.fi
.HP 42
struct\ hostent\ *\ \fBlwres_getipnodebyname\fR\ (const\ char\ *name, int\ af, int\ flags, int\ *error_num);
.HP 42
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_getnameinfo.3,v 1.15.2.4 2005/05/12 23:55:53 sra Exp $
+.\" $Id: lwres_getnameinfo.3,v 1.15.2.5 2005/09/12 00:28:56 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_getnameinfo \- lightweight resolver socket address structure to hostname and service name
.SH "SYNOPSIS"
+.nf
#include <lwres/netdb\&.h>
-.sp
+.fi
.HP 23
int\ \fBlwres_getnameinfo\fR\ (const\ struct\ sockaddr\ *sa, size_t\ salen, char\ *host, size_t\ hostlen, char\ *serv, size_t\ servlen, int\ flags);
.SH "DESCRIPTION"
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_getrrsetbyname.3,v 1.11.2.4 2005/05/12 23:55:54 sra Exp $
+.\" $Id: lwres_getrrsetbyname.3,v 1.11.2.5 2005/09/12 00:28:57 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_getrrsetbyname, lwres_freerrset \- retrieve DNS records
.SH "SYNOPSIS"
+.nf
#include <lwres/netdb\&.h>
-.sp
+.fi
.HP 26
int\ \fBlwres_getrrsetbyname\fR\ (const\ char\ *hostname, unsigned\ int\ rdclass, unsigned\ int\ rdtype, unsigned\ int\ flags, struct\ rrsetinfo\ **res);
.HP 22
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_gnba.3,v 1.13.2.4 2005/05/12 23:55:55 sra Exp $
+.\" $Id: lwres_gnba.3,v 1.13.2.5 2005/09/12 00:28:57 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_gnbarequest_render, lwres_gnbaresponse_render, lwres_gnbarequest_parse, lwres_gnbaresponse_parse, lwres_gnbaresponse_free, lwres_gnbarequest_free \- lightweight resolver getnamebyaddress message handling
.SH "SYNOPSIS"
+.nf
#include <lwres/lwres\&.h>
-.sp
+.fi
.HP 41
lwres_result_t\ \fBlwres_gnbarequest_render\fR\ (lwres_context_t\ *\fIctx\fR, lwres_gnbarequest_t\ *\fIreq\fR, lwres_lwpacket_t\ *\fIpkt\fR, lwres_buffer_t\ *\fIb\fR);
.HP 42
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_hstrerror.3,v 1.13.2.4 2005/05/12 23:55:55 sra Exp $
+.\" $Id: lwres_hstrerror.3,v 1.13.2.5 2005/09/12 00:28:57 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_herror, lwres_hstrerror \- lightweight resolver error message generation
.SH "SYNOPSIS"
+.nf
#include <lwres/netdb\&.h>
-.sp
+.fi
.HP 19
void\ \fBlwres_herror\fR\ (const\ char\ *s);
.HP 32
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_inetntop.3,v 1.12.2.4 2005/05/12 23:55:55 sra Exp $
+.\" $Id: lwres_inetntop.3,v 1.12.2.5 2005/09/12 00:28:58 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_net_ntop \- lightweight resolver IP address presentation
.SH "SYNOPSIS"
+.nf
#include <lwres/net\&.h>
-.sp
+.fi
.HP 31
const\ char\ *\ \fBlwres_net_ntop\fR\ (int\ af, const\ void\ *src, char\ *dst, size_t\ size);
.SH "DESCRIPTION"
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_noop.3,v 1.14.2.4 2005/05/12 23:55:56 sra Exp $
+.\" $Id: lwres_noop.3,v 1.14.2.5 2005/09/12 00:28:58 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_nooprequest_render, lwres_noopresponse_render, lwres_nooprequest_parse, lwres_noopresponse_parse, lwres_noopresponse_free, lwres_nooprequest_free \- lightweight resolver no-op message handling
.SH "SYNOPSIS"
+.nf
#include <lwres/lwres\&.h>
-.sp
+.fi
.HP 41
lwres_result_t\ \fBlwres_nooprequest_render\fR\ (lwres_context_t\ *ctx, lwres_nooprequest_t\ *req, lwres_lwpacket_t\ *pkt, lwres_buffer_t\ *b);
.HP 42
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_packet.3,v 1.15.2.4 2005/05/12 23:55:57 sra Exp $
+.\" $Id: lwres_packet.3,v 1.15.2.5 2005/09/12 00:28:59 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_lwpacket_renderheader, lwres_lwpacket_parseheader \- lightweight resolver packet handling functions
.SH "SYNOPSIS"
+.nf
#include <lwres/lwpacket\&.h>
-.sp
+.fi
.HP 44
lwres_result_t\ \fBlwres_lwpacket_renderheader\fR\ (lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt);
.HP 43
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: lwres_resutil.3,v 1.14.2.4 2005/05/12 23:55:57 sra Exp $
+.\" $Id: lwres_resutil.3,v 1.14.2.5 2005/09/12 00:29:00 marka Exp $
.\"
.hy 0
.ad l
.SH NAME
lwres_string_parse, lwres_addr_parse, lwres_getaddrsbyname, lwres_getnamebyaddr \- lightweight resolver utility functions
.SH "SYNOPSIS"
+.nf
#include <lwres/lwres\&.h>
-.sp
+.fi
.HP 35
lwres_result_t\ \fBlwres_string_parse\fR\ (lwres_buffer_t\ *b, char\ **c, lwres_uint16_t\ *len);
.HP 33