lwres_hstrerror.html revision 02004b6ff1357b0b97147058d54b58e9f29d8452
25cc5fbba63f84b47e389af749f55abbbde71c8cChristian Maeder - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
25cc5fbba63f84b47e389af749f55abbbde71c8cChristian Maeder - Copyright (C) 2000, 2001 Internet Software Consortium.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - Permission to use, copy, modify, and distribute this software for any
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - 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
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - 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
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
b9625461755578f3eed04676d42a63fd2caebd0cChristian Maeder - PERFORMANCE OF THIS SOFTWARE.
ebde431fb3ce536c8bc397fcfc610ac6f92e3be4Christian Maeder<!-- $Id: lwres_hstrerror.html,v 1.15 2005/07/18 02:57:53 marka Exp $ -->
97812b7ce9860bf514a8822a63503451795dbc65Klaus Luettich<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
404166b9366552e9ec5abb87a37c76ec8a815fb7Klaus Luettich<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
404166b9366552e9ec5abb87a37c76ec8a815fb7Klaus Luettich<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<a name="id2456972"></a><div class="titlepage"></div>
ac0bbbcb2774629bb87986e69cf53d3402c5f575Christian Maeder<p>lwres_herror, lwres_hstrerror — lightweight resolver error message generation</p>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<pre class="funcsynopsisinfo">#include <lwres/netdb.h></pre>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<b class="fsfunc">lwres_herror</b>(</code>const char *<var class="pdparam">s</var><code>)</code>;</p>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<b class="fsfunc">lwres_hstrerror</b>(</code>int <var class="pdparam">err</var><code>)</code>;</p>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<a name="id2514546"></a><h2>DESCRIPTION</h2>
b0294d73dcefc502ddaa13e18b46103a5916971fTill Mossakowski<p><code class="function">lwres_herror()</code>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder prints the string <em class="parameter"><code>s</code></em> on
77a65251ee036c6aaf09c2775315a4ee24259fbdJorina Freya Gerken <span class="type">stderr</span> followed by the string generated by
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder <code class="function">lwres_hstrerror()</code> for the error code stored
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder in the global variable <code class="constant">lwres_h_errno</code>.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<p><code class="function">lwres_hstrerror()</code>
97812b7ce9860bf514a8822a63503451795dbc65Klaus Luettich returns an appropriate string for the error code gievn by
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder <em class="parameter"><code>err</code></em>. The values of the error codes and
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder messages are as follows:
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<dt><span class="term"><span class="errorcode">NETDB_SUCCESS</span></span></dt>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<dd><p><span class="errorname">Resolver Error 0 (no error)</span>
8b0f493ae42bad8b94918cc0957f1af57096cda4Felix Reckers<dt><span class="term"><span class="errorcode">HOST_NOT_FOUND</span></span></dt>
4e7050bcbcf0f372a5bad32ecd0282bccabf0983Klaus Luettich<dd><p><span class="errorname">Unknown host</span>
ac0bbbcb2774629bb87986e69cf53d3402c5f575Christian Maeder<dt><span class="term"><span class="errorcode">TRY_AGAIN</span></span></dt>
33d042fe6a9eb27a4c48f840b80838f3e7d98e34Christian Maeder<dd><p><span class="errorname">Host name lookup failure</span>
ce50fe187cdae64e75e510daafb78156280bdb91Christian Maeder<dt><span class="term"><span class="errorcode">NO_RECOVERY</span></span></dt>
ebe517300051f765f2ed856a789dd5613d681ab0Klaus Luettich<dd><p><span class="errorname">Unknown server error</span>
c55a0f77be7e88d3620b419ec8961f4379a586e3Klaus Luettich<dt><span class="term"><span class="errorcode">NO_DATA</span></span></dt>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<dd><p><span class="errorname">No address associated with name</span>
c55a0f77be7e88d3620b419ec8961f4379a586e3Klaus Luettich The string <span class="errorname">Unknown resolver error</span> is returned by
ac0bbbcb2774629bb87986e69cf53d3402c5f575Christian Maeder <code class="function">lwres_hstrerror()</code>
ac0bbbcb2774629bb87986e69cf53d3402c5f575Christian Maeder when the value of
ac0bbbcb2774629bb87986e69cf53d3402c5f575Christian Maeder <code class="constant">lwres_h_errno</code>
ac0bbbcb2774629bb87986e69cf53d3402c5f575Christian Maeder is not a valid error code.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<p><span class="citerefentry"><span class="refentrytitle">herror</span>(3)</span>,
8b0f493ae42bad8b94918cc0957f1af57096cda4Felix Reckers <span class="citerefentry"><span class="refentrytitle">lwres_hstrerror</span>(3)</span>.