lwres_hstrerror.docbook revision ddccd5811feff696ba460dabfb666ce61040f545
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<!--
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - Copyright (C) 2000, 2001 Internet Software Consortium.
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara -
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - Permission to use, copy, modify, and distribute this software for any
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - purpose with or without fee is hereby granted, provided that the above
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - copyright notice and this permission notice appear in all copies.
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara -
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara-->
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<!-- $Id: lwres_hstrerror.docbook,v 1.1 2001/03/31 00:08:18 gson Exp $ -->
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refentry>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refentryinfo>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
d6c71e7b06ef8919af4c8186b4ffb08766c20a09neil_a_wilson<date>Jun 30, 2000</date>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</refentryinfo>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refmeta>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refentrytitle>lwres_hstrerror</refentrytitle>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<manvolnum>3</manvolnum>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refmiscinfo>BIND9</refmiscinfo>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</refmeta>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refnamediv>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refname>lwres_herror</refname>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refname>lwres_hstrerror</refname>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refpurpose>lightweight resolver error message generation</refpurpose>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</refnamediv>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refsynopsisdiv>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<funcsynopsis>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<funcprototype>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<funcdef>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergaravoid
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<function>lwres_herror</function></funcdef>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<paramdef>const char *s</paramdef>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</funcprototype>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<funcprototype>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<funcdef>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergaraconst char *
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<function>lwres_hstrerror</function></funcdef>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<paramdef>int err</paramdef>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</funcprototype>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</funcsynopsis>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</refsynopsisdiv>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refsect1>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<title>DESCRIPTION</title>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<function>lwres_herror()</function>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergaraprints the string
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<parameter>s</parameter>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergaraon
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<type>stderr</type>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergarafollowed by the string generated by
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<function>lwres_hstrerror()</function>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergarafor the error code stored in the global variable
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<constant>lwres_h_errno</constant>.
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara</para>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<para>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<function>lwres_hstrerror()</function>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergarareturns an appropriate string for the error code gievn by
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<parameter>err</parameter>.
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergaraThe values of the error codes and messages are as follows:
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<variablelist>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<varlistentry><term><errorcode>NETDB_SUCCESS</errorcode></term>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<listitem>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<errorname>Resolver Error 0 (no error)</errorname>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</listitem>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<varlistentry><term><errorcode>HOST_NOT_FOUND</errorcode></term>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<listitem>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<errorname>Unknown host</errorname>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</listitem>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<varlistentry><term><errorcode>TRY_AGAIN</errorcode></term>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<listitem>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<para>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<errorname>Host name lookup failure</errorname>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara</listitem>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<varlistentry><term><errorcode>NO_RECOVERY</errorcode></term>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<listitem>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<errorname>Unknown server error</errorname>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</listitem>
2401d3c2af505789c7c3b860a43e973f27731243jvergara<varlistentry><term><errorcode>NO_DATA</errorcode></term>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<listitem>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<errorname>No address associated with name</errorname>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</listitem>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</variablelist>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara</para>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara</refsect1>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<refsect1>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<title>RETURN VALUES</title>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<para>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergaraThe string <errorname>Unknown resolver error</errorname> is returned by
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<function>lwres_hstrerror()</function>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergarawhen the value of
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<constant>lwres_h_errno</constant>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergarais not a valid error code.
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara</para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</refsect1>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refsect1>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<title>SEE ALSO</title>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<para>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara<citerefentry>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<refentrytitle>herror</refentrytitle><manvolnum>3</manvolnum>
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara</citerefentry>,
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara<citerefentry>
2401d3c2af505789c7c3b860a43e973f27731243jvergara<refentrytitle>lwres_hstrerror</refentrytitle><manvolnum>3</manvolnum>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</citerefentry>.
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</para>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</refsect1>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara</refentry>
ee28309f0fe43e03bacd8fd1c7a573cd1ff534cajvergara