lib/liblwres/man/lwres_hstrerror.html

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