lwres_hstrerror.docbook revision d4ef65050feac78554addf6e16a06c6e2e0bd331
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
794b79e6bbc3f5db1ea6ae154d739b9f1ef1a375Tinderbox User<!--
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2001 Internet Software Consortium.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Permission to use, copy, modify, and distribute this software for any
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - purpose with or without fee is hereby granted, provided that the above
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - copyright notice and this permission notice appear in all copies.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein-->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- $Id: lwres_hstrerror.docbook,v 1.2 2001/04/10 21:51:57 bwelling Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<refentryinfo>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<date>Jun 30, 2000</date>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</refentryinfo>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refmeta>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refentrytitle>lwres_hstrerror</refentrytitle>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<manvolnum>3</manvolnum>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refmiscinfo>BIND9</refmiscinfo>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</refmeta>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<refname>lwres_herror</refname>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refname>lwres_hstrerror</refname>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refpurpose>lightweight resolver error message generation</refpurpose>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</refnamediv>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refsynopsisdiv>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<funcsynopsis>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<funcprototype>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<funcdef>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox Uservoid
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<function>lwres_herror</function></funcdef>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<paramdef>const char *s</paramdef>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</funcprototype>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<funcprototype>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<funcdef>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinconst char *
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<function>lwres_hstrerror</function></funcdef>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<paramdef>int err</paramdef>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</funcprototype>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</funcsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<title>DESCRIPTION</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<function>lwres_herror()</function>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox Userprints the string
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<parameter>s</parameter>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinon
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<type>stderr</type>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox Userfollowed by the string generated by
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<function>lwres_hstrerror()</function>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinfor the error code stored in the global variable
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<constant>lwres_h_errno</constant>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<function>lwres_hstrerror()</function>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinreturns an appropriate string for the error code gievn by
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<parameter>err</parameter>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinThe values of the error codes and messages are as follows:
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<variablelist>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<varlistentry><term><errorcode>NETDB_SUCCESS</errorcode></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<errorname>Resolver Error 0 (no error)</errorname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</listitem>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<varlistentry><term><errorcode>HOST_NOT_FOUND</errorcode></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<errorname>Unknown host</errorname>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<varlistentry><term><errorcode>TRY_AGAIN</errorcode></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<errorname>Host name lookup failure</errorname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<varlistentry><term><errorcode>NO_RECOVERY</errorcode></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<listitem>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<errorname>Unknown server error</errorname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</listitem>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<varlistentry><term><errorcode>NO_DATA</errorcode></term>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<errorname>No address associated with name</errorname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</listitem>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<refsect1>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<title>RETURN VALUES</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinThe string <errorname>Unknown resolver error</errorname> is returned by
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<function>lwres_hstrerror()</function>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox Userwhen the value of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<constant>lwres_h_errno</constant>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinis not a valid error code.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</para>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<title>SEE ALSO</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<para>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<refentrytitle>herror</refentrytitle><manvolnum>3</manvolnum>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</citerefentry>,
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<citerefentry>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<refentrytitle>lwres_hstrerror</refentrytitle><manvolnum>3</manvolnum>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</citerefentry>.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</para>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</refsect1>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User</refentry>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User