lwres_hstrerror.html revision 8a66318e41ed14c5a88130e8c362610e8faa2121
88f849e5723c03ee1476b48a345c791034ab5681Adam Moore<!--
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - Copyright (C) 2001 Internet Software Consortium.
88f849e5723c03ee1476b48a345c791034ab5681Adam Moore -
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - Permission to use, copy, modify, and distribute this software for any
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - purpose with or without fee is hereby granted, provided that the above
2ec5e93ed2763d6703026f4b5ac43e850a447747Nicholas C. Zakas - copyright notice and this permission notice appear in all copies.
2ec5e93ed2763d6703026f4b5ac43e850a447747Nicholas C. Zakas -
2ec5e93ed2763d6703026f4b5ac43e850a447747Nicholas C. Zakas - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
2ec5e93ed2763d6703026f4b5ac43e850a447747Nicholas C. Zakas - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
2ec5e93ed2763d6703026f4b5ac43e850a447747Nicholas C. Zakas - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas - PERFORMANCE OF THIS SOFTWARE.
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas-->
9f07526b4143bd56d662c42b82c38343f5217ff7Nicholas C. Zakas
2ec5e93ed2763d6703026f4b5ac43e850a447747Nicholas C. Zakas<!-- $Id: lwres_hstrerror.html,v 1.6 2004/03/05 08:32:21 marka Exp $ -->
<HTML
><HEAD
><TITLE
>lwres_hstrerror</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.73
"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><H1
><A
NAME="AEN1"
>lwres_hstrerror</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN8"
></A
><H2
>Name</H2
>lwres_herror, lwres_hstrerror&nbsp;--&nbsp;lightweight resolver error message generation</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN13"
></A
><P
></P
><PRE
CLASS="FUNCSYNOPSISINFO"
>#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
>.</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
>