lwres_hstrerror.docbook revision c1a883f2e04d94e99c433b1f6cfd0c0338f4ed85
10139N/A<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
10139N/A "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
10139N/A [<!ENTITY mdash "&#8212;">]>
10139N/A<!--
10139N/A - Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
10139N/A - Copyright (C) 2000, 2001 Internet Software Consortium.
10139N/A -
10139N/A - Permission to use, copy, modify, and distribute this software for any
10139N/A - purpose with or without fee is hereby granted, provided that the above
10139N/A - copyright notice and this permission notice appear in all copies.
10139N/A -
10139N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
13067N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
13067N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
10139N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
10139N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
10139N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
10139N/A - PERFORMANCE OF THIS SOFTWARE.
10139N/A-->
10139N/A
10139N/A<!-- $Id: lwres_hstrerror.docbook,v 1.10 2007/01/29 23:57:22 marka Exp $ -->
10139N/A<refentry>
10139N/A
10139N/A <refentryinfo>
10139N/A <date>Jun 30, 2000</date>
10139N/A </refentryinfo>
12169N/A
10139N/A <refmeta>
10139N/A <refentrytitle>lwres_hstrerror</refentrytitle>
10139N/A <manvolnum>3</manvolnum>
10139N/A <refmiscinfo>BIND9</refmiscinfo>
10544N/A </refmeta>
10139N/A
10139N/A <docinfo>
10139N/A <copyright>
12169N/A <year>2004</year>
12169N/A <year>2005</year>
12169N/A <year>2007</year>
12169N/A <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
12169N/A </copyright>
10139N/A <copyright>
11999N/A <year>2000</year>
11999N/A <year>2001</year>
12169N/A <holder>Internet Software Consortium.</holder>
10139N/A </copyright>
13577N/A </docinfo>
10139N/A
12169N/A <refnamediv>
12169N/A <refname>lwres_herror</refname>
12169N/A <refname>lwres_hstrerror</refname>
12169N/A <refpurpose>lightweight resolver error message generation</refpurpose>
12169N/A </refnamediv>
10139N/A <refsynopsisdiv>
10139N/A <funcsynopsis>
10139N/A<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
12169N/A<funcprototype>
10139N/A <funcdef>
10139N/Avoid
10139N/A<function>lwres_herror</function></funcdef>
12169N/A <paramdef>const char *<parameter>s</parameter></paramdef>
10139N/A </funcprototype>
12169N/A<funcprototype>
12169N/A <funcdef>
12169N/Aconst char *
10139N/A<function>lwres_hstrerror</function></funcdef>
10139N/A <paramdef>int <parameter>err</parameter></paramdef>
10139N/A </funcprototype>
12169N/A</funcsynopsis>
10139N/A </refsynopsisdiv>
12169N/A
12169N/A <refsect1>
12169N/A <title>DESCRIPTION</title>
10139N/A
10139N/A <para><function>lwres_herror()</function>
12169N/A prints the string <parameter>s</parameter> on
12169N/A <type>stderr</type> followed by the string generated by
12169N/A <function>lwres_hstrerror()</function> for the error code stored
12169N/A in the global variable <constant>lwres_h_errno</constant>.
12169N/A </para>
12164N/A
11314N/A <para><function>lwres_hstrerror()</function>
10139N/A returns an appropriate string for the error code gievn by
12169N/A <parameter>err</parameter>. The values of the error codes and
12169N/A messages are as follows:
11314N/A
10139N/A <variablelist>
11425N/A <varlistentry>
11425N/A <term><errorcode>NETDB_SUCCESS</errorcode></term>
12169N/A <listitem>
12169N/A <para><errorname>Resolver Error 0 (no error)</errorname>
12169N/A </para>
12169N/A </listitem>
12169N/A </varlistentry>
12169N/A <varlistentry>
12169N/A <term><errorcode>HOST_NOT_FOUND</errorcode></term>
12169N/A <listitem>
12169N/A <para><errorname>Unknown host</errorname>
12169N/A </para>
10330N/A </listitem>
10330N/A </varlistentry>
12169N/A <varlistentry>
12169N/A <term><errorcode>TRY_AGAIN</errorcode></term>
12169N/A <listitem>
10404N/A <para><errorname>Host name lookup failure</errorname>
12169N/A </para>
12169N/A </listitem>
12169N/A </varlistentry>
10544N/A <varlistentry>
12169N/A <term><errorcode>NO_RECOVERY</errorcode></term>
12169N/A <listitem>
12169N/A <para><errorname>Unknown server error</errorname>
12169N/A </para>
12169N/A </listitem>
11908N/A </varlistentry>
12830N/A <varlistentry>
12830N/A <term><errorcode>NO_DATA</errorcode></term>
12830N/A <listitem>
12830N/A <para><errorname>No address associated with name</errorname>
12918N/A </para>
12918N/A </listitem>
12918N/A </varlistentry>
12918N/A </variablelist>
12918N/A </para>
12918N/A </refsect1>
12918N/A
12918N/A <refsect1>
10139N/A <title>RETURN VALUES</title>
10139N/A <para>
10139N/A The string <errorname>Unknown resolver error</errorname> is returned by
10139N/A <function>lwres_hstrerror()</function>
10139N/A when the value of
10139N/A <constant>lwres_h_errno</constant>
10139N/A is not a valid error code.
10139N/A </para>
10139N/A </refsect1>
10139N/A <refsect1>
10139N/A <title>SEE ALSO</title>
10139N/A <para><citerefentry>
10139N/A <refentrytitle>herror</refentrytitle><manvolnum>3</manvolnum>
10139N/A </citerefentry>,
10139N/A
10139N/A <citerefentry>
10139N/A <refentrytitle>lwres_hstrerror</refentrytitle><manvolnum>3</manvolnum>
10139N/A </citerefentry>.
10139N/A </para>
10139N/A
10139N/A </refsect1>
10139N/A</refentry><!--
10139N/A - Local variables:
10139N/A - mode: sgml
10139N/A - End:
10139N/A-->
10139N/A