lwres_gai_strerror.docbook revision 268a4475065fe6a8cd7cc707820982cf5e98f430
0N/A<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
2362N/A "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
0N/A [<!ENTITY mdash "&#8212;">]>
0N/A<!--
0N/A - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
0N/A - Copyright (C) 2000, 2001 Internet Software Consortium.
2362N/A -
0N/A - Permission to use, copy, modify, and distribute this software for any
2362N/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<!-- $Id: lwres_gai_strerror.docbook,v 1.6 2005/05/11 05:55:40 sra Exp $ -->
2362N/A<refentry>
2362N/A
2362N/A <refentryinfo>
0N/A <date>Jun 30, 2000</date>
0N/A </refentryinfo>
0N/A
0N/A <refmeta>
0N/A <refentrytitle>lwres_gai_strerror</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 <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
0N/A <refnamediv>
0N/A <refname>lwres_gai_strerror</refname>
0N/A <refpurpose>print suitable error string</refpurpose>
0N/A </refnamediv>
0N/A
0N/A <refsynopsisdiv>
0N/A <funcsynopsis>
0N/A<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
0N/A<funcprototype>
0N/A <funcdef>
0N/Achar *
0N/A<function>gai_strerror</function></funcdef>
0N/A <paramdef>int <parameter>ecode</parameter></paramdef>
0N/A </funcprototype>
0N/A</funcsynopsis>
0N/A </refsynopsisdiv>
0N/A
0N/A <refsect1>
0N/A <title>DESCRIPTION</title>
0N/A
0N/A <para><function>lwres_gai_strerror()</function>
0N/A returns an error message corresponding to an error code returned by
0N/A <function>getaddrinfo()</function>.
0N/A The following error codes and their meaning are defined in
0N/A <filename>include/lwres/netdb.h</filename>.
0N/A <variablelist>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_ADDRFAMILY</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A address family for hostname not supported
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_AGAIN</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A temporary failure in name resolution
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_BADFLAGS</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A invalid value for
0N/A <constant>ai_flags</constant>
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_FAIL</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A non-recoverable failure in name resolution
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_FAMILY</errorcode></term>
0N/A <listitem>
0N/A <para><constant>ai_family</constant> not supported
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_MEMORY</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A memory allocation failure
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_NODATA</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A no address associated with hostname
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_NONAME</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A hostname or servname not provided, or not known
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_SERVICE</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A servname not supported for <constant>ai_socktype</constant>
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_SOCKTYPE</errorcode></term>
0N/A <listitem>
0N/A <para><constant>ai_socktype</constant> not supported
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A <varlistentry>
0N/A <term><errorcode>EAI_SYSTEM</errorcode></term>
0N/A <listitem>
0N/A <para>
0N/A system error returned in errno
0N/A </para>
0N/A </listitem>
0N/A </varlistentry>
0N/A </variablelist>
0N/A The message <errorname>invalid error code</errorname> is returned if
0N/A <parameter>ecode</parameter>
0N/A is out of range.
0N/A </para>
0N/A <para><constant>ai_flags</constant>,
0N/A <constant>ai_family</constant>
0N/A and
0N/A <constant>ai_socktype</constant>
0N/A are elements of the
0N/A <type>struct addrinfo</type>
0N/A used by
0N/A <function>lwres_getaddrinfo()</function>.
0N/A </para>
0N/A </refsect1>
0N/A
0N/A <refsect1>
0N/A <title>SEE ALSO</title>
0N/A <para><citerefentry>
0N/A <refentrytitle>strerror</refentrytitle><manvolnum>3</manvolnum>
0N/A </citerefentry>,
0N/A
0N/A <citerefentry>
0N/A <refentrytitle>lwres_getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
0N/A </citerefentry>,
1216N/A
0N/A <citerefentry>
0N/A <refentrytitle>getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
0N/A </citerefentry>,
0N/A
0N/A <citerefentry>
0N/A <refentrytitle>RFC2133</refentrytitle>
0N/A </citerefentry>.
216N/A </para>
0N/A </refsect1>
0N/A</refentry><!--
0N/A - Local variables:
0N/A - mode: sgml
0N/A - End:
0N/A-->
0N/A