lwres_hstrerror.docbook revision ddccd5811feff696ba460dabfb666ce61040f545
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - Copyright (C) 2000, 2001 Internet Software Consortium.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - 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.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<!-- $Id: lwres_hstrerror.docbook,v 1.1 2001/03/31 00:08:18 gson Exp $ -->
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</refentryinfo>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<refentrytitle>lwres_hstrerror</refentrytitle>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<refpurpose>lightweight resolver error message generation</refpurpose>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<refsynopsisdiv>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<funcsynopsisinfo>#include <lwres/netdb.h></funcsynopsisinfo>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<funcprototype>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<function>lwres_herror</function></funcdef>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</funcprototype>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<funcprototype>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<function>lwres_hstrerror</function></funcdef>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</funcprototype>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</funcsynopsis>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</refsynopsisdiv>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonprints the string
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonfollowed by the string generated by
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonfor the error code stored in the global variable
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonreturns an appropriate string for the error code gievn by
ddccd5811feff696ba460dabfb666ce61040f545Andreas GustafssonThe values of the error codes and messages are as follows:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<varlistentry><term><errorcode>NETDB_SUCCESS</errorcode></term>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<errorname>Resolver Error 0 (no error)</errorname>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<varlistentry><term><errorcode>HOST_NOT_FOUND</errorcode></term>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<varlistentry><term><errorcode>TRY_AGAIN</errorcode></term>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<errorname>Host name lookup failure</errorname>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<varlistentry><term><errorcode>NO_RECOVERY</errorcode></term>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<errorname>Unknown server error</errorname>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<varlistentry><term><errorcode>NO_DATA</errorcode></term>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<errorname>No address associated with name</errorname>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</variablelist>
ddccd5811feff696ba460dabfb666ce61040f545Andreas GustafssonThe string <errorname>Unknown resolver error</errorname> is returned by
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonwhen the value of
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonis not a valid error code.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<refentrytitle>herror</refentrytitle><manvolnum>3</manvolnum>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</citerefentry>,
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<refentrytitle>lwres_hstrerror</refentrytitle><manvolnum>3</manvolnum>
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson</citerefentry>.