lwres_hstrerror.html revision 5a4557e8de2951a2796676b5ec4b6a90caa5be14
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
43b4c41fbb07705c9df321221ab9cb9832460407Christian Maeder - Copyright (C) 2000, 2001 Internet Software Consortium.
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner - Permission to use, copy, modify, and distribute this software for any
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner - purpose with or without fee is hereby granted, provided that the above
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - copyright notice and this permission notice appear in all copies.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
d23ecf32e56cce69bc42eb5c96dddf7909c623abjelmd - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
d23ecf32e56cce69bc42eb5c96dddf7909c623abjelmd - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
d23ecf32e56cce69bc42eb5c96dddf7909c623abjelmd - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - PERFORMANCE OF THIS SOFTWARE.
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<!-- $Id: lwres_hstrerror.html,v 1.16 2005/07/19 06:12:23 marka Exp $ -->
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
d23ecf32e56cce69bc42eb5c96dddf7909c623abjelmd<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<a name="id2456972"></a><div class="titlepage"></div>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<p>lwres_herror, lwres_hstrerror — lightweight resolver error message generation</p>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<pre class="funcsynopsisinfo">#include <lwres/netdb.h></pre>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<b class="fsfunc">lwres_herror</b>(</code>const char *<var class="pdparam">s</var><code>)</code>;</p>
f8597aabc9db75dcf504e3151faf220a165c90d1Eugen Kuksa<b class="fsfunc">lwres_hstrerror</b>(</code>int <var class="pdparam">err</var><code>)</code>;</p>
f8597aabc9db75dcf504e3151faf220a165c90d1Eugen Kuksa prints the string <em class="parameter"><code>s</code></em> on
a389e88e0acb83d8489bdc5e55bc5522b152bbecEugen Kuksa <span class="type">stderr</span> followed by the string generated by
a389e88e0acb83d8489bdc5e55bc5522b152bbecEugen Kuksa <code class="function">lwres_hstrerror()</code> for the error code stored
a389e88e0acb83d8489bdc5e55bc5522b152bbecEugen Kuksa in the global variable <code class="constant">lwres_h_errno</code>.
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<p><code class="function">lwres_hstrerror()</code>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner returns an appropriate string for the error code gievn by
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner <em class="parameter"><code>err</code></em>. The values of the error codes and
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner messages are as follows:
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<dt><span class="term"><span class="errorcode">NETDB_SUCCESS</span></span></dt>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<dd><p><span class="errorname">Resolver Error 0 (no error)</span>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<dt><span class="term"><span class="errorcode">HOST_NOT_FOUND</span></span></dt>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<dd><p><span class="errorname">Unknown host</span>
a84a8d508a0778b13a4d097a6dd34b95feae78acJens Elkner<dt><span class="term"><span class="errorcode">TRY_AGAIN</span></span></dt>
60e6795dd310e10194e12bb660575aadf941328bEugen Kuksa<dd><p><span class="errorname">Host name lookup failure</span>
e7757995211bd395dc79d26fe017d99375f7d2a6Christian Maeder<dt><span class="term"><span class="errorcode">NO_RECOVERY</span></span></dt>
e7757995211bd395dc79d26fe017d99375f7d2a6Christian Maeder<dd><p><span class="errorname">Unknown server error</span>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder<dt><span class="term"><span class="errorcode">NO_DATA</span></span></dt>
c0c2380bced8159ff0297ece14eba948bd236471Christian Maeder<dd><p><span class="errorname">No address associated with name</span>
bab2d88d650448628730ed3b65c9f99c52500e8cChristian Maeder The string <span class="errorname">Unknown resolver error</span> is returned by
ce5b44277ea06257548ff625e928cb1290c6d297cmaeder when the value of
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <code class="constant">lwres_h_errno</code>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder is not a valid error code.
3dde4051c307b609159a097f08a05108fdd036efJonathan von Schroeder<a name="id2514761"></a><h2>SEE ALSO</h2>
3dde4051c307b609159a097f08a05108fdd036efJonathan von Schroeder<p><span class="citerefentry"><span class="refentrytitle">herror</span>(3)</span>,
3dde4051c307b609159a097f08a05108fdd036efJonathan von Schroeder <span class="citerefentry"><span class="refentrytitle">lwres_hstrerror</span>(3)</span>.