contrib/bind-9.2.4rc7/lib/lwres/man/lwres_hstrerror.html

   1 <!--
   2  - Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
   3  - Copyright (C) 2001  Internet Software Consortium.
   4  -
   5  - Permission to use, copy, modify, and distribute this software for any
   6  - purpose with or without fee is hereby granted, provided that the above
   7  - copyright notice and this permission notice appear in all copies.
   8  -
   9  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  10  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11  - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15  - PERFORMANCE OF THIS SOFTWARE.
  16 -->
  17
  18 <!-- $Id: lwres_hstrerror.html,v 1.5.2.2 2004/03/15 04:45:03 marka Exp $ -->
  19
  20 <HTML
  21 ><HEAD
  22 ><TITLE
  23 >lwres_hstrerror</TITLE
  24 ><META
  25 NAME="GENERATOR"
  26 CONTENT="Modular DocBook HTML Stylesheet Version 1.73
  27 "></HEAD
  28 ><BODY
  29 CLASS="REFENTRY"
  30 BGCOLOR="#FFFFFF"
  31 TEXT="#000000"
  32 LINK="#0000FF"
  33 VLINK="#840084"
  34 ALINK="#0000FF"
  35 ><H1
  36 ><A
  37 NAME="AEN1"
  38 >lwres_hstrerror</A
  39 ></H1
  40 ><DIV
  41 CLASS="REFNAMEDIV"
  42 ><A
  43 NAME="AEN8"
  44 ></A
  45 ><H2
  46 >Name</H2
  47 >lwres_herror, lwres_hstrerror&nbsp;--&nbsp;lightweight resolver error message generation</DIV
  48 ><DIV
  49 CLASS="REFSYNOPSISDIV"
  50 ><A
  51 NAME="AEN12"
  52 ></A
  53 ><H2
  54 >Synopsis</H2
  55 ><DIV
  56 CLASS="FUNCSYNOPSIS"
  57 ><A
  58 NAME="AEN13"
  59 ></A
  60 ><P
  61 ></P
  62 ><PRE
  63 CLASS="FUNCSYNOPSISINFO"
  64 >#include &lt;lwres/netdb.h&gt;</PRE
  65 ><P
  66 ><CODE
  67 ><CODE
  68 CLASS="FUNCDEF"
  69 >void
  70 lwres_herror</CODE
  71 >(const char *s);</CODE
  72 ></P
  73 ><P
  74 ><CODE
  75 ><CODE
  76 CLASS="FUNCDEF"
  77 >const char *
  78 lwres_hstrerror</CODE
  79 >(int err);</CODE
  80 ></P
  81 ><P
  82 ></P
  83 ></DIV
  84 ></DIV
  85 ><DIV
  86 CLASS="REFSECT1"
  87 ><A
  88 NAME="AEN23"
  89 ></A
  90 ><H2
  91 >DESCRIPTION</H2
  92 ><P
  93 ><TT
  94 CLASS="FUNCTION"
  95 >lwres_herror()</TT
  96 > prints the string
  97 <TT
  98 CLASS="PARAMETER"
  99 ><I
 100 >s</I
 101 ></TT
 102 > on <SPAN
 103 CLASS="TYPE"
 104 >stderr</SPAN
 105 > followed by the string
 106 generated by <TT
 107 CLASS="FUNCTION"
 108 >lwres_hstrerror()</TT
 109 > for the error code
 110 stored in the global variable <TT
 111 CLASS="CONSTANT"
 112 >lwres_h_errno</TT
 113 >.</P
 114 ><P
 115 ><TT
 116 CLASS="FUNCTION"
 117 >lwres_hstrerror()</TT
 118 > returns an appropriate string
 119 for the error code gievn by <TT
 120 CLASS="PARAMETER"
 121 ><I
 122 >err</I
 123 ></TT
 124 >.  The values of
 125 the error codes and messages are as follows:
 126
 127 <P
 128 ></P
 129 ><DIV
 130 CLASS="VARIABLELIST"
 131 ><DL
 132 ><DT
 133 ><SPAN
 134 CLASS="ERRORCODE"
 135 >NETDB_SUCCESS</SPAN
 136 ></DT
 137 ><DD
 138 ><P
 139 ><SPAN
 140 CLASS="ERRORNAME"
 141 >Resolver Error 0 (no error)</SPAN
 142 ></P
 143 ></DD
 144 ><DT
 145 ><SPAN
 146 CLASS="ERRORCODE"
 147 >HOST_NOT_FOUND</SPAN
 148 ></DT
 149 ><DD
 150 ><P
 151 ><SPAN
 152 CLASS="ERRORNAME"
 153 >Unknown host</SPAN
 154 ></P
 155 ></DD
 156 ><DT
 157 ><SPAN
 158 CLASS="ERRORCODE"
 159 >TRY_AGAIN</SPAN
 160 ></DT
 161 ><DD
 162 ><P
 163 ><SPAN
 164 CLASS="ERRORNAME"
 165 >Host name lookup failure</SPAN
 166 ></P
 167 ></DD
 168 ><DT
 169 ><SPAN
 170 CLASS="ERRORCODE"
 171 >NO_RECOVERY</SPAN
 172 ></DT
 173 ><DD
 174 ><P
 175 ><SPAN
 176 CLASS="ERRORNAME"
 177 >Unknown server error</SPAN
 178 ></P
 179 ></DD
 180 ><DT
 181 ><SPAN
 182 CLASS="ERRORCODE"
 183 >NO_DATA</SPAN
 184 ></DT
 185 ><DD
 186 ><P
 187 ><SPAN
 188 CLASS="ERRORNAME"
 189 >No address associated with name</SPAN
 190 ></P
 191 ></DD
 192 ></DL
 193 ></DIV
 194 ></P
 195 ></DIV
 196 ><DIV
 197 CLASS="REFSECT1"
 198 ><A
 199 NAME="AEN65"
 200 ></A
 201 ><H2
 202 >RETURN VALUES</H2
 203 ><P
 204 >The string <SPAN
 205 CLASS="ERRORNAME"
 206 >Unknown resolver error</SPAN
 207 > is returned by
 208 <TT
 209 CLASS="FUNCTION"
 210 >lwres_hstrerror()</TT
 211 >
 212 when the value of
 213 <TT
 214 CLASS="CONSTANT"
 215 >lwres_h_errno</TT
 216 >
 217 is not a valid error code.</P
 218 ></DIV
 219 ><DIV
 220 CLASS="REFSECT1"
 221 ><A
 222 NAME="AEN71"
 223 ></A
 224 ><H2
 225 >SEE ALSO</H2
 226 ><P
 227 ><SPAN
 228 CLASS="CITEREFENTRY"
 229 ><SPAN
 230 CLASS="REFENTRYTITLE"
 231 >herror</SPAN
 232 >(3)</SPAN
 233 >,
 234
 235 <SPAN
 236 CLASS="CITEREFENTRY"
 237 ><SPAN
 238 CLASS="REFENTRYTITLE"
 239 >lwres_hstrerror</SPAN
 240 >(3)</SPAN
 241 >.</P
 242 ></DIV
 243 ></BODY
 244 ></HTML
 245 >