2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-09-01 06:55:30 +00:00

regenerated

This commit is contained in:
Andreas Gustafsson
2001-07-02 21:29:16 +00:00
parent 47ad4fad77
commit 00380255bd
8 changed files with 95 additions and 128 deletions

View File

@@ -143,10 +143,6 @@ allocates
\fIlen\fR \fIlen\fR
bytes of memory and if successful returns a pointer to the allocated bytes of memory and if successful returns a pointer to the allocated
storage. storage.
\fBlwres_context_allocmem()\fR
checks that
\fIlen\fR
must be greater than 0.
\fBlwres_context_freemem()\fR \fBlwres_context_freemem()\fR
frees frees
\fIlen\fR \fIlen\fR

View File

@@ -364,18 +364,6 @@ bytes of memory and if successful returns a pointer to the allocated
storage. storage.
<TT <TT
CLASS="FUNCTION" CLASS="FUNCTION"
>lwres_context_allocmem()</TT
>
checks that
<TT
CLASS="PARAMETER"
><I
>len</I
></TT
>
must be greater than 0.
<TT
CLASS="FUNCTION"
>lwres_context_freemem()</TT >lwres_context_freemem()</TT
> >
frees frees
@@ -434,7 +422,7 @@ CLASS="PARAMETER"
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN117" NAME="AEN115"
></A ></A
><H2 ><H2
>RETURN VALUES</H2 >RETURN VALUES</H2
@@ -497,7 +485,7 @@ times out waiting for a response.</P
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN132" NAME="AEN130"
></A ></A
><H2 ><H2
>SEE ALSO</H2 >SEE ALSO</H2

View File

@@ -118,9 +118,25 @@ created by a call to
.SH "RETURN VALUES" .SH "RETURN VALUES"
.PP .PP
\fBlwres_getrrsetbyname()\fR \fBlwres_getrrsetbyname()\fR
returns zero on success or an error code if an error occurs. The defined returns zero on success, and one of the following error
error codes are ERRSET_NOMEMORY (memory could not be allocated), codes if an error occurred:
ERRSET_INVAL (a parameter is invalid) and ERRSET_FAIL (other failure). .TP
\fBERRSET_NONAME\fR
the name does not exist
.TP
\fBERRSET_NODATA\fR
the name exists, but does not have data of the desired type
.TP
\fBERRSET_NOMEMORY\fR
memory could not be allocated
.TP
\fBERRSET_INVAL\fR
a parameter is invalid
.TP
\fBERRSET_FAIL\fR
other failure
.TP
\fB\fR
.SH "SEE ALSO" .SH "SEE ALSO"
.PP .PP
\fBlwres\fR(3). \fBlwres\fR(3).

View File

@@ -285,14 +285,75 @@ NAME="AEN62"
CLASS="FUNCTION" CLASS="FUNCTION"
>lwres_getrrsetbyname()</TT >lwres_getrrsetbyname()</TT
> >
returns zero on success or an error code if an error occurs. The defined returns zero on success, and one of the following error
error codes are ERRSET_NOMEMORY (memory could not be allocated), codes if an error occurred:
ERRSET_INVAL (a parameter is invalid) and ERRSET_FAIL (other failure).</P <P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="CONSTANT"
>ERRSET_NONAME</TT
></DT
><DD
><P
>the name does not exist</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_NODATA</TT
></DT
><DD
><P
>the name exists, but does not have data of the desired type</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_NOMEMORY</TT
></DT
><DD
><P
>memory could not be allocated</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_INVAL</TT
></DT
><DD
><P
>a parameter is invalid</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_FAIL</TT
></DT
><DD
><P
>other failure</P
></DD
><DT
><TT
CLASS="CONSTANT"
></TT
></DT
><DD
><P
></P
></DD
></DL
></DIV
>&#13;</P
></DIV ></DIV
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN66" NAME="AEN97"
></A ></A
><H2 ><H2
>SEE ALSO</H2 >SEE ALSO</H2

View File

@@ -138,10 +138,6 @@ buffer \fI*b\fR to resolver packet
\fI*pkt\fR. The contents of the buffer \fI*pkt\fR. The contents of the buffer
\fIb\fR should correspond to a \fIb\fR should correspond to a
\fBlwres_lwpacket_t\fR. \fBlwres_lwpacket_t\fR.
.PP
Both functions have assertion checks to ensure that
\fIb\fR and \fIpkt\fR are not
\fBNULL\fR.
.SH "RETURN VALUES" .SH "RETURN VALUES"
.PP .PP
Successful calls to Successful calls to

View File

@@ -329,28 +329,11 @@ CLASS="PARAMETER"
CLASS="TYPE" CLASS="TYPE"
>lwres_lwpacket_t</SPAN >lwres_lwpacket_t</SPAN
>.</P >.</P
><P
>Both functions have assertion checks to ensure that
<TT
CLASS="PARAMETER"
><I
>b</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>pkt</I
></TT
> are not
<SPAN
CLASS="TYPE"
>NULL</SPAN
>.</P
></DIV ></DIV
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN111" NAME="AEN107"
></A ></A
><H2 ><H2
>RETURN VALUES</H2 >RETURN VALUES</H2

View File

@@ -50,12 +50,9 @@ length of that string is given by \fI*len\fR. The
buffer's current pointer is advanced to point at the character buffer's current pointer is advanced to point at the character
following the string length, the encoded string, and the trailing following the string length, the encoded string, and the trailing
\fBNULL\fR character. \fBNULL\fR character.
\fBlwres_string_parse()\fR has an assertion check that
\fIb\fR is not \fBNULL\fR.
.PP .PP
\fBlwres_addr_parse()\fR extracts an address from the \fBlwres_addr_parse()\fR extracts an address from the
buffer \fIb\fR. It checks that buffer \fIb\fR. The buffer's current pointer
\fIaddr\fR is not null. The buffer's current pointer
b->current is presumed to point at an encoded b->current is presumed to point at an encoded
address: the address preceded by a 32-bit protocol family identifier address: the address preceded by a 32-bit protocol family identifier
and a 16-bit length field. The encoded address is copied to and a 16-bit length field. The encoded address is copied to
@@ -101,9 +98,6 @@ addresses are to be looked up. Current values for this bitmask are
\fBLWRES_ADDRTYPE_V4\fR for IPv4 addresses and \fBLWRES_ADDRTYPE_V4\fR for IPv4 addresses and
\fBLWRES_ADDRTYPE_V6\fR for IPv6 addresses. Results of the \fBLWRES_ADDRTYPE_V6\fR for IPv6 addresses. Results of the
lookup are returned in \fI*structp\fR. lookup are returned in \fI*structp\fR.
\fBlwres_getaddrsbyname()\fR checks that its pointer
arguments are not \fBNULL\fR and that
\fIaddrtypes\fR is non-zero.
.PP .PP
\fBlwres_getnamebyaddr()\fR performs reverse lookups. \fBlwres_getnamebyaddr()\fR performs reverse lookups.
Resolver context \fIctx\fR is used for memory Resolver context \fIctx\fR is used for memory
@@ -112,13 +106,7 @@ allocation. The address type is indicated by
\fBLWRES_ADDRTYPE_V6\fR. The address to be looked up is given \fBLWRES_ADDRTYPE_V6\fR. The address to be looked up is given
by \fIaddr\fR and its length is by \fIaddr\fR and its length is
\fIaddrlen\fR bytes. The result of the function call \fIaddrlen\fR bytes. The result of the function call
is made available through \fI*structp\fR. Like is made available through \fI*structp\fR.
\fBlwres_getaddrsbyname()\fR,
\fBlwres_getnamebyaddr()\fR uses assertion checking to
ensure its pointer arguments are not \fBNULL\fR and
\fIaddrtype\fR is not zero.
\fBlwres_getaddrsbyname()\fR also checks that
\fIaddrlen\fR is non-zero.
.SH "RETURN VALUES" .SH "RETURN VALUES"
.PP .PP
Successful calls to Successful calls to

View File

@@ -135,20 +135,7 @@ following the string length, the encoded string, and the trailing
<SPAN <SPAN
CLASS="TYPE" CLASS="TYPE"
>NULL</SPAN >NULL</SPAN
> character. > character.</P
<TT
CLASS="FUNCTION"
>lwres_string_parse()</TT
> has an assertion check that
<TT
CLASS="PARAMETER"
><I
>b</I
></TT
> is not <SPAN
CLASS="TYPE"
>NULL</SPAN
>.</P
><P ><P
><TT ><TT
CLASS="FUNCTION" CLASS="FUNCTION"
@@ -159,13 +146,7 @@ CLASS="PARAMETER"
><I ><I
>b</I >b</I
></TT ></TT
>. It checks that >. The buffer's current pointer
<TT
CLASS="PARAMETER"
><I
>addr</I
></TT
> is not null. The buffer's current pointer
<TT <TT
CLASS="CONSTANT" CLASS="CONSTANT"
>b-&gt;current</TT >b-&gt;current</TT
@@ -265,21 +246,7 @@ CLASS="PARAMETER"
><I ><I
>*structp</I >*structp</I
></TT ></TT
>. >.</P
<TT
CLASS="FUNCTION"
>lwres_getaddrsbyname()</TT
> checks that its pointer
arguments are not <SPAN
CLASS="TYPE"
>NULL</SPAN
> and that
<TT
CLASS="PARAMETER"
><I
>addrtypes</I
></TT
> is non-zero. </P
><P ><P
><TT ><TT
CLASS="FUNCTION" CLASS="FUNCTION"
@@ -322,40 +289,12 @@ CLASS="PARAMETER"
><I ><I
>*structp</I >*structp</I
></TT ></TT
>. Like >.</P
<TT
CLASS="FUNCTION"
>lwres_getaddrsbyname()</TT
>,
<TT
CLASS="FUNCTION"
>lwres_getnamebyaddr()</TT
> uses assertion checking to
ensure its pointer arguments are not <SPAN
CLASS="TYPE"
>NULL</SPAN
> and
<TT
CLASS="PARAMETER"
><I
>addrtype</I
></TT
> is not zero.
<TT
CLASS="FUNCTION"
>lwres_getaddrsbyname()</TT
> also checks that
<TT
CLASS="PARAMETER"
><I
>addrlen</I
></TT
> is non-zero.</P
></DIV ></DIV
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN97" NAME="AEN84"
></A ></A
><H2 ><H2
>RETURN VALUES</H2 >RETURN VALUES</H2
@@ -447,7 +386,7 @@ small.</P
><DIV ><DIV
CLASS="REFSECT1" CLASS="REFSECT1"
><A ><A
NAME="AEN118" NAME="AEN105"
></A ></A
><H2 ><H2
>SEE ALSO</H2 >SEE ALSO</H2