lwres_gai_strerror.docbook revision 194e2dfffa6a167b8eef0ad11864026b423a1c30
f743002678eb67b99bbc29fee116b65d9530fec0wrowe<!--
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg - Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
6736c640e65e06990ef33af71ee81fac4df4ff5fjim -
f3e6a806627268af432188250a8fc4765cff9cf1humbedooh - This Source Code Form is subject to the terms of the Mozilla Public
f3e6a806627268af432188250a8fc4765cff9cf1humbedooh - License, v. 2.0. If a copy of the MPL was not distributed with this
f3e6a806627268af432188250a8fc4765cff9cf1humbedooh - file, You can obtain one at http://mozilla.org/MPL/2.0/.
ecd29be3e73a1fc5c79d90d2c972520c381f534dtrawick-->
ecd29be3e73a1fc5c79d90d2c972520c381f534dtrawick
ecd29be3e73a1fc5c79d90d2c972520c381f534dtrawick<!-- Converted by db4-upgrade version 1.0 -->
a5a16c0e1cfa8dfe987ab3f424dbb0d1746c0c6bjorton<refentry xmlns="http://docbook.org/ns/docbook" version="5.0">
a5a16c0e1cfa8dfe987ab3f424dbb0d1746c0c6bjorton <info>
a5a16c0e1cfa8dfe987ab3f424dbb0d1746c0c6bjorton <date>2007-06-18</date>
174b19659bdfe1b63e7154ef1af796612985c7dbjorton </info>
174b19659bdfe1b63e7154ef1af796612985c7dbjorton <refentryinfo>
174b19659bdfe1b63e7154ef1af796612985c7dbjorton <corpname>ISC</corpname>
174b19659bdfe1b63e7154ef1af796612985c7dbjorton <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
174b19659bdfe1b63e7154ef1af796612985c7dbjorton </refentryinfo>
174b19659bdfe1b63e7154ef1af796612985c7dbjorton
9b778cf6122bc2ecd5704aaec99ee22f95764e62trawick <refmeta>
9b778cf6122bc2ecd5704aaec99ee22f95764e62trawick <refentrytitle>lwres_gai_strerror</refentrytitle>
9b778cf6122bc2ecd5704aaec99ee22f95764e62trawick <manvolnum>3</manvolnum>
850ba9505c2d10d3e26c648caa968a1d41c57395sf <refmiscinfo>BIND9</refmiscinfo>
850ba9505c2d10d3e26c648caa968a1d41c57395sf </refmeta>
850ba9505c2d10d3e26c648caa968a1d41c57395sf
850ba9505c2d10d3e26c648caa968a1d41c57395sf <docinfo>
12b987b969f03ef98d9175a53d849ab62f5684fecovener <copyright>
12b987b969f03ef98d9175a53d849ab62f5684fecovener <year>2000</year>
e20c6ecbd465cd7dabb44acea6afafc7925f3a03sf <year>2001</year>
e20c6ecbd465cd7dabb44acea6afafc7925f3a03sf <year>2004</year>
7025945569c7fbb49f2e64e0d26f861d22a54675jorton <year>2005</year>
f5b3f41700a107b9df2b3c5a1cc3e5ea775fd8fesf <year>2007</year>
f5b3f41700a107b9df2b3c5a1cc3e5ea775fd8fesf <year>2014</year>
f5b3f41700a107b9df2b3c5a1cc3e5ea775fd8fesf <year>2015</year>
ec7851f543720a66e94295707116b4bc91961030sf <year>2016</year>
ec7851f543720a66e94295707116b4bc91961030sf <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
ec7851f543720a66e94295707116b4bc91961030sf </copyright>
304257c2b0d71c1e4cf3c5c819bb6b60e7c82d51sf </docinfo>
304257c2b0d71c1e4cf3c5c819bb6b60e7c82d51sf
304257c2b0d71c1e4cf3c5c819bb6b60e7c82d51sf <refnamediv>
304257c2b0d71c1e4cf3c5c819bb6b60e7c82d51sf <refname>lwres_gai_strerror</refname>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf <refpurpose>print suitable error string</refpurpose>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf </refnamediv>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf
099c357f282d4aebf2b32264f7dce6ffc0497c37sf <refsynopsisdiv>
d9b079a6dd66d36313be56f859c8c61153146527sf <funcsynopsis>
d9b079a6dd66d36313be56f859c8c61153146527sf<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
d9b079a6dd66d36313be56f859c8c61153146527sf<funcprototype>
50f8c80eb4d3989ebf3f1341aeef4d2d302af162sf <funcdef>
50f8c80eb4d3989ebf3f1341aeef4d2d302af162sfchar *
4bb0a88a01fb7b494bb02a8b881b5eab0308bda6sf<function>gai_strerror</function></funcdef>
50f8c80eb4d3989ebf3f1341aeef4d2d302af162sf <paramdef>int <parameter>ecode</parameter></paramdef>
7b395e4e878c28a4784919cfd2e704ddd14a3390jorton </funcprototype>
7b395e4e878c28a4784919cfd2e704ddd14a3390jorton</funcsynopsis>
7b395e4e878c28a4784919cfd2e704ddd14a3390jorton </refsynopsisdiv>
7b395e4e878c28a4784919cfd2e704ddd14a3390jorton
536e48c08d674acac5d44929318f2ad928edc361jorton <refsection><info><title>DESCRIPTION</title></info>
536e48c08d674acac5d44929318f2ad928edc361jorton
e81785da447b469da66f218b3f0244aab507958djorton
e81785da447b469da66f218b3f0244aab507958djorton <para><function>lwres_gai_strerror()</function>
424b4e796cde9df955948c354cb4df6080a92d4esf returns an error message corresponding to an error code returned by
424b4e796cde9df955948c354cb4df6080a92d4esf <function>getaddrinfo()</function>.
424b4e796cde9df955948c354cb4df6080a92d4esf The following error codes and their meaning are defined in
3e4e54d4e3fc0123c63d57aa84ac7ad7a8c73ff8jorton <filename>include/lwres/netdb.h</filename>.
3e4e54d4e3fc0123c63d57aa84ac7ad7a8c73ff8jorton <variablelist>
3e4e54d4e3fc0123c63d57aa84ac7ad7a8c73ff8jorton <varlistentry>
459eaf0826f995b73a0dc066f59ea10d2824e72dsf <term><errorcode>EAI_ADDRFAMILY</errorcode></term>
459eaf0826f995b73a0dc066f59ea10d2824e72dsf <listitem>
459eaf0826f995b73a0dc066f59ea10d2824e72dsf <para>
459eaf0826f995b73a0dc066f59ea10d2824e72dsf address family for hostname not supported
53e9b27aba029b18be814df40bcf6f0428771d1efuankg </para>
53e9b27aba029b18be814df40bcf6f0428771d1efuankg </listitem>
53e9b27aba029b18be814df40bcf6f0428771d1efuankg </varlistentry>
53e9b27aba029b18be814df40bcf6f0428771d1efuankg <varlistentry>
53e9b27aba029b18be814df40bcf6f0428771d1efuankg <term><errorcode>EAI_AGAIN</errorcode></term>
6bb524f1895f30265a1431afc460977d391cb36bsf <listitem>
6bb524f1895f30265a1431afc460977d391cb36bsf <para>
ca61ccd0c306c2c72df153688ba1b49f3eceed80sf temporary failure in name resolution
6bb524f1895f30265a1431afc460977d391cb36bsf </para>
b40bfdb714672f972887f9f1f1e154e00125bb68covener </listitem>
b40bfdb714672f972887f9f1f1e154e00125bb68covener </varlistentry>
b40bfdb714672f972887f9f1f1e154e00125bb68covener <varlistentry>
b40bfdb714672f972887f9f1f1e154e00125bb68covener <term><errorcode>EAI_BADFLAGS</errorcode></term>
e6dd71992459d05a676b98b7963423dc5dc1e24aminfrin <listitem>
e6dd71992459d05a676b98b7963423dc5dc1e24aminfrin <para>
e6dd71992459d05a676b98b7963423dc5dc1e24aminfrin invalid value for
e6dd71992459d05a676b98b7963423dc5dc1e24aminfrin <constant>ai_flags</constant>
23f1535d6a60817d2846bac0aea230ea475d7dccminfrin </para>
23f1535d6a60817d2846bac0aea230ea475d7dccminfrin </listitem>
23f1535d6a60817d2846bac0aea230ea475d7dccminfrin </varlistentry>
23f1535d6a60817d2846bac0aea230ea475d7dccminfrin <varlistentry>
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung <term><errorcode>EAI_FAIL</errorcode></term>
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung <listitem>
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung <para>
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung non-recoverable failure in name resolution
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung </para>
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung </listitem>
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung </varlistentry>
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjung <varlistentry>
6249dfa569d3b4f1f539665b979a80c6e335d93etrawick <term><errorcode>EAI_FAMILY</errorcode></term>
6249dfa569d3b4f1f539665b979a80c6e335d93etrawick <listitem>
0827cb14e550f6f65018431c22c2c913631c8f25kbrand <para><constant>ai_family</constant> not supported
6249dfa569d3b4f1f539665b979a80c6e335d93etrawick </para>
ae600ca541efc686b34f8b1f21bd3d0741d37674covener </listitem>
6249dfa569d3b4f1f539665b979a80c6e335d93etrawick </varlistentry>
cfa64348224b66dd1c9979b809406c4d15b1c137fielding <varlistentry>
74499a117b3b2cd9666715a14f90c0e5d1a4ee8ajim <term><errorcode>EAI_MEMORY</errorcode></term>
cfa64348224b66dd1c9979b809406c4d15b1c137fielding <listitem>
74499a117b3b2cd9666715a14f90c0e5d1a4ee8ajim <para>
cfa64348224b66dd1c9979b809406c4d15b1c137fielding memory allocation failure
74499a117b3b2cd9666715a14f90c0e5d1a4ee8ajim </para>
cfa64348224b66dd1c9979b809406c4d15b1c137fielding </listitem>
74499a117b3b2cd9666715a14f90c0e5d1a4ee8ajim </varlistentry>
cfa64348224b66dd1c9979b809406c4d15b1c137fielding <varlistentry>
<term><errorcode>EAI_NODATA</errorcode></term>
<listitem>
<para>
no address associated with hostname
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><errorcode>EAI_NONAME</errorcode></term>
<listitem>
<para>
hostname or servname not provided, or not known
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><errorcode>EAI_SERVICE</errorcode></term>
<listitem>
<para>
servname not supported for <constant>ai_socktype</constant>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><errorcode>EAI_SOCKTYPE</errorcode></term>
<listitem>
<para><constant>ai_socktype</constant> not supported
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><errorcode>EAI_SYSTEM</errorcode></term>
<listitem>
<para>
system error returned in errno
</para>
</listitem>
</varlistentry>
</variablelist>
The message <errorname>invalid error code</errorname> is returned if
<parameter>ecode</parameter>
is out of range.
</para>
<para><constant>ai_flags</constant>,
<constant>ai_family</constant>
and
<constant>ai_socktype</constant>
are elements of the
<type>struct addrinfo</type>
used by
<function>lwres_getaddrinfo()</function>.
</para>
</refsection>
<refsection><info><title>SEE ALSO</title></info>
<para><citerefentry>
<refentrytitle>strerror</refentrytitle><manvolnum>3</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>lwres_getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>RFC2133</refentrytitle>
</citerefentry>.
</para>
</refsection>
</refentry>