lwres_gai_strerror.docbook revision 0c27b3fe77ac1d5094ba3521e8142d9e7973133f
8e496a172b2000333186e5c1be75a50f398ed830vboxsync<!--
8e496a172b2000333186e5c1be75a50f398ed830vboxsync - Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
ad27e1d5e48ca41245120c331cc88b50464813cevboxsync -
8e496a172b2000333186e5c1be75a50f398ed830vboxsync - This Source Code Form is subject to the terms of the Mozilla Public
8e496a172b2000333186e5c1be75a50f398ed830vboxsync - License, v. 2.0. If a copy of the MPL was not distributed with this
8e496a172b2000333186e5c1be75a50f398ed830vboxsync - file, You can obtain one at http://mozilla.org/MPL/2.0/.
c7814cf6e1240a519cbec0441e033d0e2470ed00vboxsync-->
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync<!-- Converted by db4-upgrade version 1.0 -->
8e496a172b2000333186e5c1be75a50f398ed830vboxsync<refentry xmlns="http://docbook.org/ns/docbook" version="5.0">
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <info>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <date>2007-06-18</date>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </info>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refentryinfo>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <corpname>ISC</corpname>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </refentryinfo>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refmeta>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refentrytitle>lwres_gai_strerror</refentrytitle>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <manvolnum>3</manvolnum>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refmiscinfo>BIND9</refmiscinfo>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </refmeta>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <docinfo>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <copyright>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <year>2004</year>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <year>2005</year>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <year>2007</year>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <year>2014</year>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <year>2015</year>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <year>2016</year>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </copyright>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <copyright>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <year>2000</year>
ad27e1d5e48ca41245120c331cc88b50464813cevboxsync <year>2001</year>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <holder>Internet Software Consortium.</holder>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </copyright>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </docinfo>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refnamediv>
086e9df69b43a69e8ba17ed712aeca047342913bvboxsync <refname>lwres_gai_strerror</refname>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refpurpose>print suitable error string</refpurpose>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </refnamediv>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refsynopsisdiv>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <funcsynopsis>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync<funcprototype>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <funcdef>
8e496a172b2000333186e5c1be75a50f398ed830vboxsyncchar *
8e496a172b2000333186e5c1be75a50f398ed830vboxsync<function>gai_strerror</function></funcdef>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <paramdef>int <parameter>ecode</parameter></paramdef>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </funcprototype>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync</funcsynopsis>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </refsynopsisdiv>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refsection><info><title>DESCRIPTION</title></info>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para><function>lwres_gai_strerror()</function>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync returns an error message corresponding to an error code returned by
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <function>getaddrinfo()</function>.
8e496a172b2000333186e5c1be75a50f398ed830vboxsync The following error codes and their meaning are defined in
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <filename>include/lwres/netdb.h</filename>.
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <variablelist>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_ADDRFAMILY</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync address family for hostname not supported
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_AGAIN</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync temporary failure in name resolution
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_BADFLAGS</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync invalid value for
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <constant>ai_flags</constant>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_FAIL</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync non-recoverable failure in name resolution
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_FAMILY</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para><constant>ai_family</constant> not supported
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_MEMORY</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
3a5d16e1911830b585d10278ea2cdbb408e261e6vboxsync memory allocation failure
3a5d16e1911830b585d10278ea2cdbb408e261e6vboxsync </para>
3a5d16e1911830b585d10278ea2cdbb408e261e6vboxsync </listitem>
3a5d16e1911830b585d10278ea2cdbb408e261e6vboxsync </varlistentry>
3a5d16e1911830b585d10278ea2cdbb408e261e6vboxsync <varlistentry>
3a5d16e1911830b585d10278ea2cdbb408e261e6vboxsync <term><errorcode>EAI_NODATA</errorcode></term>
3a5d16e1911830b585d10278ea2cdbb408e261e6vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync no address associated with hostname
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_NONAME</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync hostname or servname not provided, or not known
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_SERVICE</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync servname not supported for <constant>ai_socktype</constant>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_SOCKTYPE</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para><constant>ai_socktype</constant> not supported
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <term><errorcode>EAI_SYSTEM</errorcode></term>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync system error returned in errno
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </listitem>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </varlistentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </variablelist>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync The message <errorname>invalid error code</errorname> is returned if
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <parameter>ecode</parameter>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync is out of range.
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para><constant>ai_flags</constant>,
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <constant>ai_family</constant>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync and
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <constant>ai_socktype</constant>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync are elements of the
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <type>struct addrinfo</type>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync used by
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <function>lwres_getaddrinfo()</function>.
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </refsection>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refsection><info><title>SEE ALSO</title></info>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <para><citerefentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refentrytitle>strerror</refentrytitle><manvolnum>3</manvolnum>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </citerefentry>,
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <citerefentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refentrytitle>lwres_getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </citerefentry>,
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <citerefentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refentrytitle>getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </citerefentry>,
8e496a172b2000333186e5c1be75a50f398ed830vboxsync
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <citerefentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync <refentrytitle>RFC2133</refentrytitle>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </citerefentry>.
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </para>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync </refsection>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync</refentry>
8e496a172b2000333186e5c1be75a50f398ed830vboxsync