regen
This commit is contained in:
@@ -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"
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
>. </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
|
||||
>. </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
|
||||
>
|
||||
— typically a lightweight resolver query packet —
|
||||
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
|
||||
>. </P
|
||||
></DIV
|
||||
><DIV
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
> — <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
|
||||
> — <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"
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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:
|
||||
|
||||
|
||||
@@ -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
|
||||
> — IPv4 or IPv6 —
|
||||
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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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"
|
||||
|
||||
@@ -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->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
|
||||
|
||||
Reference in New Issue
Block a user