lwres_hstrerror.html revision 8a66318e41ed14c5a88130e8c362610e8faa2121
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - Copyright (C) 2001 Internet Software Consortium.
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - Permission to use, copy, modify, and distribute this software for any
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - purpose with or without fee is hereby granted, provided that the above
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - copyright notice and this permission notice appear in all copies.
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews - PERFORMANCE OF THIS SOFTWARE.
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews<!-- $Id: lwres_hstrerror.html,v 1.6 2004/03/05 08:32:21 marka Exp $ -->
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_hstrerror</TITLE
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsNAME="GENERATOR"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCONTENT="Modular DocBook HTML Stylesheet Version 1.73
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFENTRY"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsBGCOLOR="#FFFFFF"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsTEXT="#000000"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsLINK="#0000FF"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsVLINK="#840084"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsALINK="#0000FF"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_hstrerror</A
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFNAMEDIV"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_herror, lwres_hstrerror -- lightweight resolver error message generation</DIV
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFSYNOPSISDIV"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>Synopsis</H2
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCSYNOPSIS"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCSYNOPSISINFO"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCDEF"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewslwres_herror</CODE
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>(const char *s);</CODE
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCDEF"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>const char *
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewslwres_hstrerror</CODE
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>(int err);</CODE
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFSECT1"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>DESCRIPTION</H2
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCTION"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_herror()</TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews> prints the string
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="PARAMETER"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>stderr</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews> followed by the string
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewsgenerated by <TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCTION"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_hstrerror()</TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews> for the error code
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewsstored in the global variable <TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="CONSTANT"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_h_errno</TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCTION"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_hstrerror()</TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews> returns an appropriate string
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewsfor the error code gievn by <TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="PARAMETER"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>. The values of
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewsthe error codes and messages are as follows:
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="VARIABLELIST"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORCODE"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>NETDB_SUCCESS</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORNAME"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>Resolver Error 0 (no error)</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORCODE"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>HOST_NOT_FOUND</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORNAME"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>Unknown host</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORCODE"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>TRY_AGAIN</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORNAME"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>Host name lookup failure</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORCODE"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>NO_RECOVERY</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORNAME"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>Unknown server error</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORCODE"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>NO_DATA</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORNAME"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>No address associated with name</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFSECT1"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>RETURN VALUES</H2
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>The string <SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="ERRORNAME"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>Unknown resolver error</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews> is returned by
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="FUNCTION"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_hstrerror()</TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewswhen the value of
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="CONSTANT"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_h_errno</TT
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrewsis not a valid error code.</P
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFSECT1"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>SEE ALSO</H2
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="CITEREFENTRY"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFENTRYTITLE"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>herror</SPAN
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="CITEREFENTRY"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark AndrewsCLASS="REFENTRYTITLE"
d7c632387465363c23e4ef6a780bc4eaa47ad31dMark Andrews>lwres_hstrerror</SPAN