This commit is contained in:
Mark Andrews
2005-04-03 03:32:07 +00:00
parent 31ec08ccd0
commit d16e5588cc
41 changed files with 5371 additions and 3531 deletions

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres.html,v 1.5.18.3 2004/08/22 23:53:34 marka Exp $ -->
<!-- $Id: lwres.html,v 1.5.18.4 2005/04/03 03:32:05 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -130,9 +130,9 @@ CLASS="FUNCTION"
functions are all supported. To allow the lwres library to coexist
with system libraries that define functions of the same name,
the library defines these functions with names prefixed by
<VAR
<TT
CLASS="LITERAL"
>lwres_</VAR
>lwres_</TT
>.
To define the standard names, applications must include the
header file
@@ -142,9 +142,9 @@ CLASS="FILENAME"
>
which contains macro definitions mapping the standard function names
into
<VAR
<TT
CLASS="LITERAL"
>lwres_</VAR
>lwres_</TT
>
prefixed ones. Operating system vendors who integrate the lwres
library into their base distributions should rename the functions
@@ -201,9 +201,9 @@ sequence of actions.</P
CLASS="TYPE"
>lwres_packet_t</SPAN
>,
called <VAR
called <CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
> below.</P
><P
>(2) Set <CODE
@@ -293,9 +293,9 @@ CLASS="FUNCTION"
unmarshall it. This returns a <SPAN
CLASS="TYPE"
>lwres_packet_t</SPAN
> (also called <VAR
> (also called <CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
>, below)
as well as a data specific type, such as <SPAN
CLASS="TYPE"

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_buffer.html,v 1.5.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_buffer.html,v 1.5.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_buffer</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -205,9 +205,9 @@ NAME="AEN106"
>These functions provide bounds checked access to a region of memory
where data is being read or written.
They are based on, and similar to, the
<VAR
<TT
CLASS="LITERAL"
>isc_buffer_</VAR
>isc_buffer_</TT
>
functions in the ISC library.</P
><P
@@ -317,19 +317,19 @@ initializes the
CLASS="TYPE"
>lwres_buffer_t</SPAN
>
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
and assocates it with the memory region of size
<VAR
<CODE
CLASS="PARAMETER"
>length</VAR
>length</CODE
>
bytes starting at location
<VAR
<CODE
CLASS="PARAMETER"
>base.</VAR
>base.</CODE
></P
><P
><CODE
@@ -337,9 +337,9 @@ CLASS="FUNCTION"
>lwres_buffer_invalidate()</CODE
>
marks the buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
as invalid. Invalidating a buffer after use is not required,
but makes it possible to catch its possible accidental use.</P
@@ -356,14 +356,14 @@ CLASS="FUNCTION"
>
respectively increase and decrease the used space in
buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
by
<VAR
<CODE
CLASS="PARAMETER"
>n</VAR
>n</CODE
>
bytes.
<CODE
@@ -409,9 +409,9 @@ CLASS="FUNCTION"
>lwres_buffer_first</CODE
>
makes the consumed region of buffer
<VAR
<CODE
CLASS="PARAMETER"
>*p</VAR
>*p</CODE
>
empty by setting
<CODE
@@ -425,14 +425,14 @@ CLASS="FUNCTION"
>lwres_buffer_forward()</CODE
>
increases the consumed region of buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
by
<VAR
<CODE
CLASS="PARAMETER"
>n</VAR
>n</CODE
>
bytes, checking for overflow.
Similarly,
@@ -441,14 +441,14 @@ CLASS="FUNCTION"
>lwres_buffer_back()</CODE
>
decreases buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>'s
consumed region by
<VAR
<CODE
CLASS="PARAMETER"
>n</VAR
>n</CODE
>
bytes and checks for underflow.</P
><P
@@ -457,9 +457,9 @@ CLASS="FUNCTION"
>lwres_buffer_getuint8()</CODE
>
reads an unsigned 8-bit integer from
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
and returns it.
<CODE
@@ -467,14 +467,14 @@ CLASS="FUNCTION"
>lwres_buffer_putuint8()</CODE
>
writes the unsigned 8-bit integer
<VAR
<CODE
CLASS="PARAMETER"
>val</VAR
>val</CODE
>
to buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>.</P
><P
><CODE
@@ -493,9 +493,9 @@ CLASS="FUNCTION"
>
except that they respectively read an unsigned 16-bit or 32-bit integer
in network byte order from
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>.
Similarly,
<CODE
@@ -508,14 +508,14 @@ CLASS="FUNCTION"
>lwres_buffer_putuint32()</CODE
>
writes the unsigned 16-bit or 32-bit integer
<VAR
<CODE
CLASS="PARAMETER"
>val</VAR
>val</CODE
>
to buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>,
in network byte order.</P
><P
@@ -536,19 +536,19 @@ CLASS="FUNCTION"
>lwres_buffer_putmem()</CODE
>
copies
<VAR
<CODE
CLASS="PARAMETER"
>length</VAR
>length</CODE
>
bytes of memory at
<VAR
<CODE
CLASS="PARAMETER"
>base</VAR
>base</CODE
>
to
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>.
Conversely,
<CODE
@@ -556,19 +556,19 @@ CLASS="FUNCTION"
>lwres_buffer_getmem()</CODE
>
copies
<VAR
<CODE
CLASS="PARAMETER"
>length</VAR
>length</CODE
>
bytes of memory from
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
to
<VAR
<CODE
CLASS="PARAMETER"
>base</VAR
>base</CODE
>.</P
></DIV
></BODY

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_config.html,v 1.5.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_config.html,v 1.5.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_config</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -124,9 +124,9 @@ CLASS="TYPE"
>lwres_conf_t</SPAN
>
structure for lightweight resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>.</P
><P
><CODE
@@ -140,9 +140,9 @@ CLASS="TYPE"
>lwres_conf_t</SPAN
>
structure in resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>.</P
><P
><CODE
@@ -150,14 +150,14 @@ CLASS="FUNCTION"
>lwres_conf_parse()</CODE
>
opens the file
<VAR
<CODE
CLASS="PARAMETER"
>filename</VAR
>filename</CODE
>
and parses it to initialise the resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>'s
<SPAN
CLASS="TYPE"
@@ -175,18 +175,18 @@ CLASS="TYPE"
>lwres_conf_t</SPAN
>
structure for resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
to the
<SPAN
CLASS="TYPE"
>FILE</SPAN
>
<VAR
<CODE
CLASS="PARAMETER"
>fp</VAR
>fp</CODE
>.</P
></DIV
><DIV
@@ -207,9 +207,9 @@ CLASS="ERRORCODE"
>LWRES_R_SUCCESS</SPAN
>
if it successfully read and parsed
<VAR
<CODE
CLASS="PARAMETER"
>filename</VAR
>filename</CODE
>.
It returns
<SPAN
@@ -217,9 +217,9 @@ CLASS="ERRORCODE"
>LWRES_R_FAILURE</SPAN
>
if
<VAR
<CODE
CLASS="PARAMETER"
>filename</VAR
>filename</CODE
>
could not be opened or contained incorrect
resolver statements.</P

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_context.html,v 1.7.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_context.html,v 1.7.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_context</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -148,9 +148,9 @@ CLASS="TYPE"
>lwres_context_t</SPAN
>
is returned through
<VAR
<CODE
CLASS="PARAMETER"
>contextp</VAR
>contextp</CODE
>,
a pointer to a
@@ -172,25 +172,25 @@ CLASS="TYPE"
><P
>When the lightweight resolver needs to perform dynamic memory
allocation, it will call
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
to allocate memory and
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
to free it. If
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
are NULL, memory is allocated using
@@ -205,36 +205,36 @@ CLASS="REFENTRYTITLE"
>.
It is not permitted to have a NULL
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
and a non-NULL
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
or vice versa.
<VAR
<CODE
CLASS="PARAMETER"
>arg</VAR
>arg</CODE
>
is passed as the first parameter to the memory
allocation functions.
If
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
are NULL,
<VAR
<CODE
CLASS="PARAMETER"
>arg</VAR
>arg</CODE
>
is unused and should be passed as NULL.</P
@@ -250,9 +250,9 @@ CLASS="REFENTRYTITLE"
>
and returned via
<VAR
<CODE
CLASS="PARAMETER"
>*contextp</VAR
>*contextp</CODE
>.&#13;</P
><P
><CODE
@@ -266,9 +266,9 @@ CLASS="TYPE"
>,
closing its socket.
<VAR
<CODE
CLASS="PARAMETER"
>contextp</VAR
>contextp</CODE
>
is a pointer to a pointer to the context that is to be destroyed.
The pointer will be set to NULL when the context has been destroyed.</P
@@ -290,14 +290,14 @@ CLASS="FUNCTION"
>lwres_context_initserial()</CODE
>
sets the serial number for context
<VAR
<CODE
CLASS="PARAMETER"
>*ctx</VAR
>*ctx</CODE
>
to
<VAR
<CODE
CLASS="PARAMETER"
>serial</VAR
>serial</CODE
>.
<CODE
@@ -327,9 +327,9 @@ CLASS="FUNCTION"
>lwres_context_allocmem()</CODE
>
allocates
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
>
bytes of memory and if successful returns a pointer to the allocated
storage.
@@ -338,14 +338,14 @@ CLASS="FUNCTION"
>lwres_context_freemem()</CODE
>
frees
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
>
bytes of space starting at location
<VAR
<CODE
CLASS="PARAMETER"
>mem</VAR
>mem</CODE
>.&#13;</P
><P
><CODE
@@ -353,29 +353,29 @@ CLASS="FUNCTION"
>lwres_context_sendrecv()</CODE
>
performs I/O for the context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>.
Data are read and written from the context's socket.
It writes data from
<VAR
<CODE
CLASS="PARAMETER"
>sendbase</VAR
>sendbase</CODE
>
&mdash; typically a lightweight resolver query packet &mdash;
and waits for a reply which is copied to the receive buffer at
<VAR
<CODE
CLASS="PARAMETER"
>recvbase</VAR
>recvbase</CODE
>.
The number of bytes that were written to this receive buffer is
returned in
<VAR
<CODE
CLASS="PARAMETER"
>*recvd_len</VAR
>*recvd_len</CODE
>.&#13;</P
></DIV
><DIV

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gabn.html,v 1.7.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_gabn.html,v 1.7.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gabn</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -183,32 +183,32 @@ CLASS="FUNCTION"
>lwres_gabnrequest_render()</CODE
>
uses resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
to convert getaddrbyname request structure
<VAR
<CODE
CLASS="PARAMETER"
>req</VAR
>req</CODE
>
to canonical format.
The packet header structure
<VAR
<CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
>
is initialised and transferred to
buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>.
The contents of
<VAR
<CODE
CLASS="PARAMETER"
>*req</VAR
>*req</CODE
>
are then appended to the buffer in canonical format.
<CODE
@@ -227,14 +227,14 @@ CLASS="FUNCTION"
>lwres_gabnrequest_parse()</CODE
>
uses context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
to convert the contents of packet
<VAR
<CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
>
to a
<SPAN
@@ -243,9 +243,9 @@ CLASS="TYPE"
>
structure.
Buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
provides space to be used for storing this structure.
When the function succeeds, the resulting
@@ -254,9 +254,9 @@ CLASS="TYPE"
>lwres_gabnrequest_t</SPAN
>
is made available through
<VAR
<CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.
<CODE
@@ -285,9 +285,9 @@ CLASS="FUNCTION"
>lwres_gabnrequest_free()</CODE
>
release the memory in resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
that was allocated to the
<SPAN
@@ -300,9 +300,9 @@ CLASS="TYPE"
>lwres_gabnrequest_t</SPAN
>
structures referenced via
<VAR
<CODE
CLASS="PARAMETER"
>structp</VAR
>structp</CODE
>.
Any memory associated with ancillary buffers and strings for those
@@ -351,9 +351,9 @@ CLASS="ERRORCODE"
>LWRES_R_UNEXPECTEDEND</SPAN
>
is returned if the available space in the buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
is too small to accommodate the packet header or the
<SPAN

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gai_strerror.html,v 1.6.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_gai_strerror.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gai_strerror</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -220,9 +220,9 @@ The message <SPAN
CLASS="ERRORNAME"
>invalid error code</SPAN
> is returned if
<VAR
<CODE
CLASS="PARAMETER"
>ecode</VAR
>ecode</CODE
>
is out of range.</P
><P

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getaddrinfo.html,v 1.10.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_getaddrinfo.html,v 1.10.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getaddrinfo</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -116,14 +116,14 @@ CLASS="FUNCTION"
>lwres_getaddrinfo()</CODE
>
is used to get a list of IP addresses and port numbers for host
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
and service
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>.
The function is the lightweight resolver's implementation of
@@ -132,14 +132,14 @@ CLASS="FUNCTION"
>getaddrinfo()</CODE
>
as defined in RFC2133.
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>
are pointers to null-terminated
strings or
@@ -148,15 +148,15 @@ CLASS="TYPE"
>NULL</SPAN
>.
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
is either a host name or a numeric host address string: a dotted decimal
IPv4 address or an IPv6 address.
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>
is either a decimal port number or a service name as listed in
<TT
@@ -164,9 +164,9 @@ CLASS="FILENAME"
>/etc/services</TT
>.</P
><P
><VAR
><CODE
CLASS="PARAMETER"
>hints</VAR
>hints</CODE
>
is an optional pointer to a
<SPAN
@@ -176,9 +176,9 @@ CLASS="TYPE"
This structure can be used to provide hints concerning the type of socket
that the caller supports or wishes to use.
The caller can supply the following structure elements in
<VAR
<CODE
CLASS="PARAMETER"
>*hints</VAR
>*hints</CODE
>:
<P
@@ -362,9 +362,9 @@ CLASS="REFENTRYTITLE"
if a connectionless protocol was chosen.
The IP address portion of the socket address structure will be
set to the loopback address if
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
is a
<SPAN
@@ -393,9 +393,9 @@ CLASS="TYPE"
>AI_NUMERICHOST</SPAN
>
it indicates that
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
should be treated as a numeric string defining an IPv4 or IPv6 address
and no name resolution should be attempted.</P
@@ -408,14 +408,14 @@ and no name resolution should be attempted.</P
CLASS="TYPE"
>struct addrinfo</SPAN
> passed
via <VAR
via <CODE
CLASS="PARAMETER"
>hints</VAR
>hints</CODE
> must be zero.</P
><P
>A <VAR
>A <CODE
CLASS="PARAMETER"
>hints</VAR
>hints</CODE
> of <SPAN
CLASS="TYPE"
>NULL</SPAN
@@ -438,9 +438,9 @@ CLASS="CONSTANT"
CLASS="FUNCTION"
>lwres_getaddrinfo()</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>*res</VAR
>*res</CODE
>
is a pointer to a linked list of one or more
<SPAN
@@ -531,9 +531,9 @@ is released by
CLASS="FUNCTION"
>lwres_freeaddrinfo()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>ai</VAR
>ai</CODE
>
is a pointer to a
<SPAN
@@ -568,14 +568,14 @@ CLASS="REFENTRYTITLE"
>
if an error occurs.
If both
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>
are
<SPAN

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gethostent.html,v 1.9.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_gethostent.html,v 1.9.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gethostent</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -319,9 +319,9 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_gethostbyname2()</CODE
> look up the hostname
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>.
<CODE
CLASS="FUNCTION"
@@ -331,9 +331,9 @@ address while <CODE
CLASS="FUNCTION"
>lwres_gethostbyname2()</CODE
> looks for an
address of protocol family <VAR
address of protocol family <CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>: either
<SPAN
CLASS="TYPE"
@@ -365,17 +365,17 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_gethostbyaddr()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>addr</VAR
>addr</CODE
> is an address of length
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes and protocol family
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
> &mdash; <SPAN
CLASS="TYPE"
>PF_INET</SPAN
@@ -389,13 +389,13 @@ CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
> is a thread-safe function
for forward lookups. If an error occurs, an error code is returned in
<VAR
<CODE
CLASS="PARAMETER"
>*error</VAR
>*error</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
> is a pointer to a <SPAN
CLASS="TYPE"
>struct
@@ -405,13 +405,13 @@ hostent</SPAN
CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
> .
<VAR
<CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
> is a buffer of length
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes which is used to store the
<CODE
CLASS="CONSTANT"
@@ -427,17 +427,17 @@ CLASS="CONSTANT"
CLASS="TYPE"
>struct
hostent</SPAN
> returned in <VAR
> returned in <CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>.
Successful calls to <CODE
CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
>
return <VAR
return <CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>,
which is a pointer to the <SPAN
CLASS="TYPE"
@@ -448,17 +448,17 @@ CLASS="TYPE"
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
> is a thread-safe function
that performs a reverse lookup of address <VAR
that performs a reverse lookup of address <CODE
CLASS="PARAMETER"
>addr</VAR
>addr</CODE
>
which is <VAR
which is <CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes long and is of protocol
family <VAR
family <CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
> &mdash; <SPAN
CLASS="TYPE"
>PF_INET</SPAN
@@ -467,17 +467,17 @@ CLASS="TYPE"
CLASS="TYPE"
>PF_INET6</SPAN
>. If an error occurs, the error code is returned
in <VAR
in <CODE
CLASS="PARAMETER"
>*error</VAR
>*error</CODE
>. The other function parameters are
identical to those in <CODE
CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
> is a pointer to a <SPAN
CLASS="TYPE"
>struct
@@ -487,13 +487,13 @@ hostent</SPAN
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
> is a buffer of length
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes which is used to store the
<CODE
CLASS="CONSTANT"
@@ -509,17 +509,17 @@ CLASS="CONSTANT"
CLASS="TYPE"
>struct
hostent</SPAN
> returned in <VAR
> returned in <CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>. Successful
calls to <CODE
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
> return
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>, which is a pointer to the
<CODE
CLASS="FUNCTION"
@@ -645,9 +645,9 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
> return
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>, a pointer to the <SPAN
CLASS="TYPE"
>struct
@@ -656,9 +656,9 @@ hostent</SPAN
<SPAN
CLASS="TYPE"
>NULL</SPAN
> if the lookups fail or if <VAR
> if the lookups fail or if <CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
>
was too small to hold the list of addresses and names referenced by
the <CODE
@@ -675,9 +675,9 @@ CLASS="CONSTANT"
CLASS="TYPE"
>struct
hostent</SPAN
>. If <VAR
>. If <CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
> was too small, both
<CODE
CLASS="FUNCTION"

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getipnode.html,v 1.9.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_getipnode.html,v 1.9.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getipnode</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -199,21 +199,21 @@ CLASS="FUNCTION"
>lwres_getipnodebyname()</CODE
>
looks up addresses of protocol family
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
for the hostname
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>.
The
<VAR
<CODE
CLASS="PARAMETER"
>flags</VAR
>flags</CODE
>
parameter contains ORed flag bits to
specify the types of addresses that are searched
@@ -232,9 +232,9 @@ CLASS="CONSTANT"
><DD
><P
>This is used with an
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
of AF_INET6, and causes IPv4 addresses to be returned as IPv4-mapped
IPv6 addresses.</P
@@ -247,9 +247,9 @@ CLASS="CONSTANT"
><DD
><P
>This is used with an
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
of AF_INET6, and causes all known addresses (IPv6 and IPv4) to be returned.
If AI_V4MAPPED is also set, the IPv4 addresses are return as mapped
@@ -295,19 +295,19 @@ CLASS="FUNCTION"
>
performs a reverse lookup
of address
<VAR
<CODE
CLASS="PARAMETER"
>src</VAR
>src</CODE
>
which is
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
>
bytes long.
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
denotes the protocol family, typically
<SPAN
@@ -331,9 +331,9 @@ CLASS="TYPE"
>struct hostent</SPAN
>
pointer
<VAR
<CODE
CLASS="PARAMETER"
>he</VAR
>he</CODE
>.
Any memory allocated for the
@@ -377,9 +377,9 @@ CLASS="FUNCTION"
>lwres_getipnodebyaddr()</CODE
>
set
<VAR
<CODE
CLASS="PARAMETER"
>*error_num</VAR
>*error_num</CODE
>
to an appropriate error code and the function returns a
<SPAN

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getnameinfo.html,v 1.6.18.3 2004/08/22 23:53:37 marka Exp $ -->
<!-- $Id: lwres_getnameinfo.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getnameinfo</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -96,21 +96,21 @@ CLASS="FUNCTION"
<SPAN
CLASS="TYPE"
>struct sockaddr</SPAN
> <VAR
> <CODE
CLASS="PARAMETER"
>sa</VAR
>sa</CODE
> which is
<VAR
<CODE
CLASS="PARAMETER"
>salen</VAR
>salen</CODE
> bytes long. The hostname is of length
<VAR
<CODE
CLASS="PARAMETER"
>hostlen</VAR
>hostlen</CODE
> and is returned via
<VAR
<CODE
CLASS="PARAMETER"
>*host.</VAR
>*host.</CODE
> The maximum length of the hostname is
1025 bytes: <CODE
CLASS="CONSTANT"
@@ -118,25 +118,25 @@ CLASS="CONSTANT"
>.</P
><P
> The name of the service associated with the port number in
<VAR
<CODE
CLASS="PARAMETER"
>sa</VAR
> is returned in <VAR
>sa</CODE
> is returned in <CODE
CLASS="PARAMETER"
>*serv.</VAR
>*serv.</CODE
>
It is <VAR
It is <CODE
CLASS="PARAMETER"
>servlen</VAR
>servlen</CODE
> bytes long. The maximum length
of the service name is <CODE
CLASS="CONSTANT"
>NI_MAXSERV</CODE
> - 32 bytes.</P
><P
> The <VAR
> The <CODE
CLASS="PARAMETER"
>flags</VAR
>flags</CODE
> argument sets the following
bits:
<P

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getrrsetbyname.html,v 1.6.18.3 2004/08/22 23:53:37 marka Exp $ -->
<!-- $Id: lwres_getrrsetbyname.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getrrsetbyname</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -116,31 +116,31 @@ CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>
gets a set of resource records associated with a
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>,
and
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
is
a pointer a to null-terminated string. The
<VAR
<CODE
CLASS="PARAMETER"
>flags</VAR
>flags</CODE
>
field is currently unused and must be zero.</P
><P
@@ -150,9 +150,9 @@ CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>*res</VAR
>*res</CODE
>
is a pointer to an
<SPAN
@@ -245,9 +245,9 @@ CLASS="FUNCTION"
>lwres_freerrset()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>rrset</VAR
>rrset</CODE
>
is a pointer to a
<SPAN

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gnba.html,v 1.7.18.3 2004/08/22 23:53:37 marka Exp $ -->
<!-- $Id: lwres_gnba.html,v 1.7.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gnba</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -176,31 +176,31 @@ CLASS="FUNCTION"
>lwres_gnbarequest_render()</CODE
>
uses resolver context
<VAR
<CODE
CLASS="VARNAME"
>ctx</VAR
>ctx</CODE
>
to convert getnamebyaddr request structure
<VAR
<CODE
CLASS="VARNAME"
>req</VAR
>req</CODE
>
to canonical format.
The packet header structure
<VAR
<CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
>
is initialised and transferred to
buffer
<VAR
<CODE
CLASS="VARNAME"
>b</VAR
>b</CODE
>.
The contents of
<VAR
<CODE
CLASS="VARNAME"
>*req</VAR
>*req</CODE
>
are then appended to the buffer in canonical format.
<CODE
@@ -219,14 +219,14 @@ CLASS="FUNCTION"
>lwres_gnbarequest_parse()</CODE
>
uses context
<VAR
<CODE
CLASS="VARNAME"
>ctx</VAR
>ctx</CODE
>
to convert the contents of packet
<VAR
<CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
>
to a
<SPAN
@@ -235,9 +235,9 @@ CLASS="TYPE"
>
structure.
Buffer
<VAR
<CODE
CLASS="VARNAME"
>b</VAR
>b</CODE
>
provides space to be used for storing this structure.
When the function succeeds, the resulting
@@ -246,9 +246,9 @@ CLASS="TYPE"
>lwres_gnbarequest_t</SPAN
>
is made available through
<VAR
<CODE
CLASS="VARNAME"
>*structp</VAR
>*structp</CODE
>.
<CODE
CLASS="FUNCTION"
@@ -276,9 +276,9 @@ CLASS="FUNCTION"
>lwres_gnbarequest_free()</CODE
>
release the memory in resolver context
<VAR
<CODE
CLASS="VARNAME"
>ctx</VAR
>ctx</CODE
>
that was allocated to the
<SPAN
@@ -291,9 +291,9 @@ CLASS="TYPE"
>lwres_gnbarequest_t</SPAN
>
structures referenced via
<VAR
<CODE
CLASS="VARNAME"
>structp</VAR
>structp</CODE
>.
Any memory associated with ancillary buffers and strings for those
structures is also discarded.</P
@@ -341,9 +341,9 @@ CLASS="ERRORCODE"
>LWRES_R_UNEXPECTEDEND</SPAN
>
is returned if the available space in the buffer
<VAR
<CODE
CLASS="VARNAME"
>b</VAR
>b</CODE
>
is too small to accommodate the packet header or the
<SPAN

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_hstrerror.html,v 1.6.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_hstrerror.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_hstrerror</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -94,9 +94,9 @@ NAME="AEN23"
CLASS="FUNCTION"
>lwres_herror()</CODE
> prints the string
<VAR
<CODE
CLASS="PARAMETER"
>s</VAR
>s</CODE
> on <SPAN
CLASS="TYPE"
>stderr</SPAN
@@ -114,9 +114,9 @@ CLASS="CONSTANT"
CLASS="FUNCTION"
>lwres_hstrerror()</CODE
> returns an appropriate string
for the error code gievn by <VAR
for the error code gievn by <CODE
CLASS="PARAMETER"
>err</VAR
>err</CODE
>. The values of
the error codes and messages are as follows:

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_inetntop.html,v 1.6.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_inetntop.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_inetntop</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -86,25 +86,25 @@ NAME="AEN21"
CLASS="FUNCTION"
>lwres_net_ntop()</CODE
> converts an IP address of
protocol family <VAR
protocol family <CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
> &mdash; IPv4 or IPv6 &mdash;
at location <VAR
at location <CODE
CLASS="PARAMETER"
>src</VAR
>src</CODE
> from network format to its
conventional representation as a string. For IPv4 addresses, that
string would be a dotted-decimal. An IPv6 address would be
represented in colon notation as described in RFC1884.</P
><P
>The generated string is copied to <VAR
>The generated string is copied to <CODE
CLASS="PARAMETER"
>dst</VAR
>dst</CODE
> provided
<VAR
<CODE
CLASS="PARAMETER"
>size</VAR
>size</CODE
> indicates it is long enough to store the
ASCII representation of the address.</P
></DIV
@@ -116,9 +116,9 @@ NAME="AEN30"
><H2
>RETURN VALUES</H2
><P
>If successful, the function returns <VAR
>If successful, the function returns <CODE
CLASS="PARAMETER"
>dst</VAR
>dst</CODE
>:
a pointer to a string containing the presentation format of the
address. <CODE
@@ -136,9 +136,9 @@ CLASS="CONSTANT"
CLASS="ERRORCODE"
>EAFNOSUPPORT</SPAN
> if
the protocol family given in <VAR
the protocol family given in <CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
> is not
supported.</P
></DIV

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_noop.html,v 1.8.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_noop.html,v 1.8.18.4 2005/04/03 03:32:07 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_noop</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -180,25 +180,25 @@ the response is therefore identical to the request.</P
CLASS="FUNCTION"
>lwres_nooprequest_render()</CODE
> uses resolver
context <VAR
context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> to convert no-op request structure
<VAR
<CODE
CLASS="PARAMETER"
>req</VAR
>req</CODE
> to canonical format. The packet header
structure <VAR
structure <CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
> is initialised and transferred to
buffer <VAR
buffer <CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>. The contents of
<VAR
<CODE
CLASS="PARAMETER"
>*req</VAR
>*req</CODE
> are then appended to the buffer in
canonical format. <CODE
CLASS="FUNCTION"
@@ -215,29 +215,29 @@ canonical format.</P
CLASS="FUNCTION"
>lwres_nooprequest_parse()</CODE
> uses context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> to convert the contents of packet
<VAR
<CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
> to a <SPAN
CLASS="TYPE"
>lwres_nooprequest_t</SPAN
>
structure. Buffer <VAR
structure. Buffer <CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
> provides space to be used
for storing this structure. When the function succeeds, the resulting
<SPAN
CLASS="TYPE"
>lwres_nooprequest_t</SPAN
> is made available through
<VAR
<CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.
<CODE
CLASS="FUNCTION"
@@ -260,9 +260,9 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_nooprequest_free()</CODE
> release the memory in
resolver context <VAR
resolver context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> that was allocated to the
<SPAN
CLASS="TYPE"
@@ -271,9 +271,9 @@ CLASS="TYPE"
CLASS="TYPE"
>lwres_nooprequest_t</SPAN
>
structures referenced via <VAR
structures referenced via <CODE
CLASS="PARAMETER"
>structp</VAR
>structp</CODE
>.</P
></DIV
><DIV
@@ -320,9 +320,9 @@ CLASS="ERRORCODE"
>LWRES_R_UNEXPECTEDEND</SPAN
>
is returned if the available space in the buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
is too small to accommodate the packet header or the
<SPAN

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_packet.html,v 1.9.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_packet.html,v 1.9.18.4 2005/04/03 03:32:07 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_packet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -291,14 +291,14 @@ contents of lightweight resolver packet structure
<SPAN
CLASS="TYPE"
>lwres_lwpacket_t</SPAN
> <VAR
> <CODE
CLASS="PARAMETER"
>*pkt</VAR
>*pkt</CODE
> in network
byte order to the lightweight resolver buffer,
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>.</P
><P
><CODE
@@ -306,17 +306,17 @@ CLASS="FUNCTION"
>lwres_lwpacket_parseheader()</CODE
> performs the
converse operation. It transfers data in network byte order from
buffer <VAR
buffer <CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
> to resolver packet
<VAR
<CODE
CLASS="PARAMETER"
>*pkt</VAR
>*pkt</CODE
>. The contents of the buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
> should correspond to a
<SPAN
CLASS="TYPE"
@@ -344,13 +344,13 @@ CLASS="FUNCTION"
CLASS="ERRORCODE"
>LWRES_R_SUCCESS</SPAN
>. If there is insufficient
space to copy data between the buffer <VAR
space to copy data between the buffer <CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
> and
lightweight resolver packet <VAR
lightweight resolver packet <CODE
CLASS="PARAMETER"
>*pkt</VAR
>*pkt</CODE
> both functions
return <SPAN
CLASS="ERRORCODE"

View File

@@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_resutil.html,v 1.9.18.3 2004/08/22 23:53:39 marka Exp $ -->
<!-- $Id: lwres_resutil.html,v 1.9.18.4 2005/04/03 03:32:07 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_resutil</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@@ -111,21 +111,21 @@ CLASS="FUNCTION"
>lwres_string_parse()</CODE
> retrieves a DNS-encoded
string starting the current pointer of lightweight resolver buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>: i.e. <CODE
CLASS="CONSTANT"
>b-&gt;current</CODE
>.
When the function returns, the address of the first byte of the
encoded string is returned via <VAR
encoded string is returned via <CODE
CLASS="PARAMETER"
>*c</VAR
>*c</CODE
> and the
length of that string is given by <VAR
length of that string is given by <CODE
CLASS="PARAMETER"
>*len</VAR
>*len</CODE
>. The
buffer's current pointer is advanced to point at the character
following the string length, the encoded string, and the trailing
@@ -138,9 +138,9 @@ CLASS="TYPE"
CLASS="FUNCTION"
>lwres_addr_parse()</CODE
> extracts an address from the
buffer <VAR
buffer <CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>. The buffer's current pointer
<CODE
CLASS="CONSTANT"
@@ -209,17 +209,17 @@ functions.</P
CLASS="FUNCTION"
>lwres_getaddrsbyname()</CODE
> to perform foward lookups.
Hostname <VAR
Hostname <CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
> is looked up using the resolver
context <VAR
context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> for memory allocation.
<VAR
<CODE
CLASS="PARAMETER"
>addrtypes</VAR
>addrtypes</CODE
> is a bitmask indicating which type of
addresses are to be looked up. Current values for this bitmask are
<SPAN
@@ -230,23 +230,23 @@ CLASS="TYPE"
CLASS="TYPE"
>LWRES_ADDRTYPE_V6</SPAN
> for IPv6 addresses. Results of the
lookup are returned in <VAR
lookup are returned in <CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.</P
><P
><CODE
CLASS="FUNCTION"
>lwres_getnamebyaddr()</CODE
> performs reverse lookups.
Resolver context <VAR
Resolver context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> is used for memory
allocation. The address type is indicated by
<VAR
<CODE
CLASS="PARAMETER"
>addrtype</VAR
>addrtype</CODE
>: <SPAN
CLASS="TYPE"
>LWRES_ADDRTYPE_V4</SPAN
@@ -255,17 +255,17 @@ CLASS="TYPE"
CLASS="TYPE"
>LWRES_ADDRTYPE_V6</SPAN
>. The address to be looked up is given
by <VAR
by <CODE
CLASS="PARAMETER"
>addr</VAR
>addr</CODE
> and its length is
<VAR
<CODE
CLASS="PARAMETER"
>addrlen</VAR
>addrlen</CODE
> bytes. The result of the function call
is made available through <VAR
is made available through <CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.</P
></DIV
><DIV
@@ -319,9 +319,9 @@ CLASS="ERRORCODE"
>LWRES_R_NOTFOUND</SPAN
>
if the hostname
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>
could not be found.</P
><P