lwres_hstrerror.html revision ddccd5811feff696ba460dabfb666ce61040f545
0N/A<!--
2362N/A - Copyright (C) 2000, 2001 Internet Software Consortium.
0N/A -
0N/A - Permission to use, copy, modify, and distribute this software for any
0N/A - purpose with or without fee is hereby granted, provided that the above
0N/A - copyright notice and this permission notice appear in all copies.
0N/A -
0N/A - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
0N/A - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
0N/A - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
0N/A - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
0N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
0N/A - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
0N/A - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
0N/A - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
0N/A-->
0N/A<HTML
0N/A><HEAD
2362N/A><TITLE
2362N/A>lwres_hstrerror</TITLE
2362N/A><META
0N/ANAME="GENERATOR"
0N/ACONTENT="Modular DocBook HTML Stylesheet Version 1.61
0N/A"></HEAD
0N/A><BODY
0N/ACLASS="REFENTRY"
1952N/ABGCOLOR="#FFFFFF"
0N/ATEXT="#000000"
0N/ALINK="#0000FF"
0N/AVLINK="#840084"
0N/AALINK="#0000FF"
0N/A><H1
0N/A><A
0N/ANAME="AEN1"
0N/A>lwres_hstrerror</A
0N/A></H1
0N/A><DIV
0N/ACLASS="REFNAMEDIV"
0N/A><A
0N/ANAME="AEN8"
0N/A></A
0N/A><H2
0N/A>Name</H2
0N/A>lwres_herror, lwres_hstrerror&nbsp;--&nbsp;lightweight resolver error message generation</DIV
0N/A><DIV
0N/ACLASS="REFSYNOPSISDIV"
0N/A><A
0N/ANAME="AEN12"
0N/A></A
0N/A><H2
0N/A>Synopsis</H2
0N/A><DIV
0N/ACLASS="FUNCSYNOPSIS"
0N/A><A
0N/ANAME="AEN13"
0N/A></A
0N/A><P
0N/A></P
0N/A><PRE
0N/ACLASS="FUNCSYNOPSISINFO"
0N/A>#include &lt;lwres/netdb.h&gt;</PRE
><P
><CODE
><CODE
CLASS="FUNCDEF"
>void
lwres_herror</CODE
>(const char *s);</CODE
></P
><P
><CODE
><CODE
CLASS="FUNCDEF"
>const char *
lwres_hstrerror</CODE
>(int err);</CODE
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23"
></A
><H2
>DESCRIPTION</H2
><P
><TT
CLASS="FUNCTION"
>lwres_herror()</TT
>
prints the string
<TT
CLASS="PARAMETER"
><I
>s</I
></TT
>
on
<SPAN
CLASS="TYPE"
>stderr</SPAN
>
followed by the string generated by
<TT
CLASS="FUNCTION"
>lwres_hstrerror()</TT
>
for the error code stored in the global variable
<TT
CLASS="CONSTANT"
>lwres_h_errno</TT
>.&#13;</P
><P
><TT
CLASS="FUNCTION"
>lwres_hstrerror()</TT
>
returns an appropriate string for the error code gievn by
<TT
CLASS="PARAMETER"
><I
>err</I
></TT
>.
The values of the error codes and messages are as follows:
<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><SPAN
CLASS="ERRORCODE"
>NETDB_SUCCESS</SPAN
></DT
><DD
><P
><SPAN
CLASS="ERRORNAME"
>Resolver Error 0 (no error)</SPAN
></P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>HOST_NOT_FOUND</SPAN
></DT
><DD
><P
><SPAN
CLASS="ERRORNAME"
>Unknown host</SPAN
></P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>TRY_AGAIN</SPAN
></DT
><DD
><P
><SPAN
CLASS="ERRORNAME"
>Host name lookup failure</SPAN
></P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>NO_RECOVERY</SPAN
></DT
><DD
><P
><SPAN
CLASS="ERRORNAME"
>Unknown server error</SPAN
></P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>NO_DATA</SPAN
></DT
><DD
><P
><SPAN
CLASS="ERRORNAME"
>No address associated with name</SPAN
></P
></DD
></DL
></DIV
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN65"
></A
><H2
>RETURN VALUES</H2
><P
>The string <SPAN
CLASS="ERRORNAME"
>Unknown resolver error</SPAN
> is returned by
<TT
CLASS="FUNCTION"
>lwres_hstrerror()</TT
>
when the value of
<TT
CLASS="CONSTANT"
>lwres_h_errno</TT
>
is not a valid error code.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN71"
></A
><H2
>SEE ALSO</H2
><P
><SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>herror</SPAN
>(3)</SPAN
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>lwres_hstrerror</SPAN
>(3)</SPAN
>.</P
></DIV
></BODY
></HTML
>