lwres_hstrerror.docbook revision dafcb997e390efa4423883dafd100c975c4095d6
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
d4ef65050feac78554addf6e16a06c6e2e0bd331Brian Wellington - Copyright (C) 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.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - PERFORMANCE OF THIS SOFTWARE.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<!-- $Id: lwres_hstrerror.docbook,v 1.5 2004/03/05 05:12:57 marka 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>
86b0285d7e65601645db4090d62ee6cb63abad6cAndreas Gustafsson<function>lwres_herror()</function> prints the string
86b0285d7e65601645db4090d62ee6cb63abad6cAndreas Gustafsson<parameter>s</parameter> on <type>stderr</type> followed by the string
86b0285d7e65601645db4090d62ee6cb63abad6cAndreas Gustafssongenerated by <function>lwres_hstrerror()</function> for the error code
86b0285d7e65601645db4090d62ee6cb63abad6cAndreas Gustafssonstored in the global variable <constant>lwres_h_errno</constant>.
86b0285d7e65601645db4090d62ee6cb63abad6cAndreas Gustafsson<function>lwres_hstrerror()</function> returns an appropriate string
86b0285d7e65601645db4090d62ee6cb63abad6cAndreas Gustafssonfor the error code gievn by <parameter>err</parameter>. The values of
86b0285d7e65601645db4090d62ee6cb63abad6cAndreas Gustafssonthe 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>.