lwres_hstrerror.docbook revision 30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1
0N/A<!--
1472N/A - Copyright (C) 2004, 2005, 2007, 2014, 2015 Internet Systems Consortium, Inc. ("ISC")
0N/A - Copyright (C) 2000, 2001 Internet Software Consortium.
0N/A -
0N/A - Permission to use, copy, modify, and/or distribute this software for any
0N/A - purpose with or without fee is hereby granted, provided that the above
0N/A - copyright notice and this permission notice appear in all copies.
0N/A -
0N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
0N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
0N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
0N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
0N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
0N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
0N/A - PERFORMANCE OF THIS SOFTWARE.
0N/A-->
0N/A
0N/A<!-- Converted by db4-upgrade version 1.0 -->
1472N/A<refentry xmlns="http://docbook.org/ns/docbook" version="5.0">
1472N/A <info>
1472N/A <date>2007-06-18</date>
0N/A </info>
0N/A <refentryinfo>
0N/A <corpname>ISC</corpname>
0N/A <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
0N/A </refentryinfo>
0N/A
0N/A <refmeta>
0N/A <refentrytitle>lwres_hstrerror</refentrytitle>
0N/A <manvolnum>3</manvolnum>
0N/A <refmiscinfo>BIND9</refmiscinfo>
0N/A </refmeta>
0N/A
0N/A <docinfo>
0N/A <copyright>
0N/A <year>2004</year>
0N/A <year>2005</year>
0N/A <year>2007</year>
0N/A <year>2014</year>
0N/A <year>2015</year>
0N/A <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
0N/A </copyright>
0N/A <copyright>
0N/A <year>2000</year>
0N/A <year>2001</year>
0N/A <holder>Internet Software Consortium.</holder>
0N/A </copyright>
0N/A </docinfo>
0N/A
44N/A <refnamediv>
44N/A <refname>lwres_herror</refname>
0N/A <refname>lwres_hstrerror</refname>
0N/A <refpurpose>lightweight resolver error message generation</refpurpose>
0N/A </refnamediv>
0N/A <refsynopsisdiv>
0N/A <funcsynopsis>
0N/A<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
0N/A<funcprototype>
0N/A <funcdef>
44N/Avoid
44N/A<function>lwres_herror</function></funcdef>
44N/A <paramdef>const char *<parameter>s</parameter></paramdef>
0N/A </funcprototype>
0N/A<funcprototype>
0N/A <funcdef>
0N/Aconst char *
0N/A<function>lwres_hstrerror</function></funcdef>
0N/A <paramdef>int <parameter>err</parameter></paramdef>
0N/A </funcprototype>
0N/A</funcsynopsis>
0N/A </refsynopsisdiv>
0N/A
0N/A <refsection><info><title>DESCRIPTION</title></info>
0N/A
0N/A
0N/A <para><function>lwres_herror()</function>
0N/A prints the string <parameter>s</parameter> on
0N/A <type>stderr</type> followed by the string generated by
0N/A <function>lwres_hstrerror()</function> for the error code stored
0N/A in the global variable <constant>lwres_h_errno</constant>.
0N/A </para>
0N/A
0N/A <para><function>lwres_hstrerror()</function>
0N/A returns an appropriate string for the error code gievn by
0N/A <parameter>err</parameter>. The values of the error codes and
0N/A messages are as follows:
0N/A
0N/A <variablelist>
0N/A <varlistentry>
0N/A <term><errorcode>NETDB_SUCCESS</errorcode></term>
0N/A <listitem>
0N/A <para><errorname>Resolver Error 0 (no error)</errorname>
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>HOST_NOT_FOUND</errorcode></term>
0N/A <listitem>
0N/A <para><errorname>Unknown host</errorname>
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>TRY_AGAIN</errorcode></term>
0N/A <listitem>
0N/A <para><errorname>Host name lookup failure</errorname>
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>NO_RECOVERY</errorcode></term>
0N/A <listitem>
0N/A <para><errorname>Unknown server error</errorname>
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>NO_DATA</errorcode></term>
0N/A <listitem>
0N/A <para><errorname>No address associated with name</errorname>
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A </variablelist>
0N/A </para>
0N/A </refsection>
0N/A
0N/A <refsection><info><title>RETURN VALUES</title></info>
0N/A
0N/A <para>
0N/A The string <errorname>Unknown resolver error</errorname> is returned by
0N/A <function>lwres_hstrerror()</function>
0N/A when the value of
0N/A <constant>lwres_h_errno</constant>
0N/A is not a valid error code.
0N/A </para>
0N/A </refsection>
0N/A <refsection><info><title>SEE ALSO</title></info>
0N/A
0N/A <para><citerefentry>
0N/A <refentrytitle>herror</refentrytitle><manvolnum>3</manvolnum>
0N/A </citerefentry>,
0N/A
0N/A <citerefentry>
0N/A <refentrytitle>lwres_hstrerror</refentrytitle><manvolnum>3</manvolnum>
0N/A </citerefentry>.
0N/A </para>
0N/A
0N/A </refsection>
0N/A</refentry>
0N/A