lwres_gai_strerror.docbook revision 83a28ca274521e15086fc39febde507bcc4e145e
f743002678eb67b99bbc29fee116b65d9530fec0wrowe<!--
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg - Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem -
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - This Source Code Form is subject to the terms of the Mozilla Public
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - License, v. 2.0. If a copy of the MPL was not distributed with this
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - file, You can obtain one at http://mozilla.org/MPL/2.0/.
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic-->
4da61833a1cbbca94094f9653fd970582b97a72etrawick
4da61833a1cbbca94094f9653fd970582b97a72etrawick<!-- Converted by db4-upgrade version 1.0 -->
4da61833a1cbbca94094f9653fd970582b97a72etrawick<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0">
4da61833a1cbbca94094f9653fd970582b97a72etrawick <info>
4da61833a1cbbca94094f9653fd970582b97a72etrawick <date>2007-06-18</date>
4789804be088bcd86ae637a29cdb7fda25169521jailletc </info>
4789804be088bcd86ae637a29cdb7fda25169521jailletc <refentryinfo>
4789804be088bcd86ae637a29cdb7fda25169521jailletc <corpname>ISC</corpname>
4789804be088bcd86ae637a29cdb7fda25169521jailletc <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
e50c3026198fd496f183cda4c32a202925476778covener </refentryinfo>
e50c3026198fd496f183cda4c32a202925476778covener
e50c3026198fd496f183cda4c32a202925476778covener <refmeta>
5b88c8507d5ef6d0c4cfbc78230294968175b638minfrin <refentrytitle>lwres_gai_strerror</refentrytitle>
5b88c8507d5ef6d0c4cfbc78230294968175b638minfrin <manvolnum>3</manvolnum>
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic <refmiscinfo>BIND9</refmiscinfo>
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic </refmeta>
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic <docinfo>
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic <copyright>
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic <year>2000</year>
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic <year>2001</year>
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic <year>2004</year>
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic <year>2005</year>
69301145375a889e7e37caf7cc7321ac0f91801erpluem <year>2007</year>
69301145375a889e7e37caf7cc7321ac0f91801erpluem <year>2014</year>
69301145375a889e7e37caf7cc7321ac0f91801erpluem <year>2015</year>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza <year>2016</year>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza </copyright>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza </docinfo>
d58a848a016d401b965111e50ef829e1641f7834minfrin
d58a848a016d401b965111e50ef829e1641f7834minfrin <refnamediv>
d58a848a016d401b965111e50ef829e1641f7834minfrin <refname>lwres_gai_strerror</refname>
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf <refpurpose>print suitable error string</refpurpose>
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf </refnamediv>
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic <refsynopsisdiv>
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic <funcsynopsis>
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic<funcprototype>
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic <funcdef>
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavicchar *
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic<function>gai_strerror</function></funcdef>
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic <paramdef>int <parameter>ecode</parameter></paramdef>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic </funcprototype>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic</funcsynopsis>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic </refsynopsisdiv>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic <refsection><info><title>DESCRIPTION</title></info>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener <para><function>lwres_gai_strerror()</function>
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener returns an error message corresponding to an error code returned by
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener <function>getaddrinfo()</function>.
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener The following error codes and their meaning are defined in
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener <filename>include/lwres/netdb.h</filename>.
44ff304057225e944e220e981d434a046d14cf06covener <variablelist>
44ff304057225e944e220e981d434a046d14cf06covener <varlistentry>
44ff304057225e944e220e981d434a046d14cf06covener <term><errorcode>EAI_ADDRFAMILY</errorcode></term>
44ff304057225e944e220e981d434a046d14cf06covener <listitem>
5d1ba75b8794925e67591c209085a49279791de9covener <para>
5d1ba75b8794925e67591c209085a49279791de9covener address family for hostname not supported
5d1ba75b8794925e67591c209085a49279791de9covener </para>
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand </listitem>
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand </varlistentry>
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand <varlistentry>
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand <term><errorcode>EAI_AGAIN</errorcode></term>
caad2986f81ab263f7af41467dd622dc9add17f3ylavic <listitem>
caad2986f81ab263f7af41467dd622dc9add17f3ylavic <para>
caad2986f81ab263f7af41467dd622dc9add17f3ylavic temporary failure in name resolution
caad2986f81ab263f7af41467dd622dc9add17f3ylavic </para>
45a10d38e6051fd7bdf9d742aaae633d97ff02abjailletc </listitem>
f7317ff316c2b141feea31bddb74d5d3fa1584edjorton </varlistentry>
f7317ff316c2b141feea31bddb74d5d3fa1584edjorton <varlistentry>
2165214331e4afafca4048f66f303d0253d7b001covener <term><errorcode>EAI_BADFLAGS</errorcode></term>
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem <listitem>
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem <para>
1e2d421a36999d292042a5539971070d54aa6c63ylavic invalid value for
1e2d421a36999d292042a5539971070d54aa6c63ylavic <constant>ai_flags</constant>
1e2d421a36999d292042a5539971070d54aa6c63ylavic </para>
fa7ed98b9dc94c5845cf845aea0a44ecacd290c9humbedooh </listitem>
fa7ed98b9dc94c5845cf845aea0a44ecacd290c9humbedooh </varlistentry>
fa7ed98b9dc94c5845cf845aea0a44ecacd290c9humbedooh <varlistentry>
0b67eb8568cd58bb77082703951679b42cf098actrawick <term><errorcode>EAI_FAIL</errorcode></term>
0b67eb8568cd58bb77082703951679b42cf098actrawick <listitem>
0b67eb8568cd58bb77082703951679b42cf098actrawick <para>
0b67eb8568cd58bb77082703951679b42cf098actrawick non-recoverable failure in name resolution
5ef3c61605a3a021ff71f488983cb0065f8e1a79covener </para>
fb1985a97912b25ec6564c73e610a31e5fc6e25fcovener </listitem>
09c87c777bed1655621bb20e1c46cb6b1a63279dcovener </varlistentry>
6502b7b32f980cc2093bb3ebce37e5e4dc68fba4ylavic <varlistentry>
6502b7b32f980cc2093bb3ebce37e5e4dc68fba4ylavic <term><errorcode>EAI_FAMILY</errorcode></term>
3060ce7f798fbda7999cd4ddf89b525d2b294185covener <listitem>
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic <para><constant>ai_family</constant> not supported
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic </para>
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic </listitem>
e6b4bd1113567627ab6bb6c6a7105e1e01a7d889jailletc </varlistentry>
e6b4bd1113567627ab6bb6c6a7105e1e01a7d889jailletc <varlistentry>
e466c40e1801982602ee0200c9e8b61cc148742djailletc <term><errorcode>EAI_MEMORY</errorcode></term>
e466c40e1801982602ee0200c9e8b61cc148742djailletc <listitem>
457468b82e59d01eba00dd9d0817309c8f5e414ejim <para>
457468b82e59d01eba00dd9d0817309c8f5e414ejim memory allocation failure
457468b82e59d01eba00dd9d0817309c8f5e414ejim </para>
04983e3bd1754764eec7d6bb772fe3b0bf391771jorton </listitem>
04983e3bd1754764eec7d6bb772fe3b0bf391771jorton </varlistentry>
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem <varlistentry>
15660979a30d251681463de2e0584853890082accovener <term><errorcode>EAI_NODATA</errorcode></term>
15660979a30d251681463de2e0584853890082accovener <listitem>
49dacedb6c387b786b7911082ff35121a45f414bcovener <para>
49dacedb6c387b786b7911082ff35121a45f414bcovener no address associated with hostname
cfd9415521847b2f9394fad04fb701cfb955f503rjung </para>
cfd9415521847b2f9394fad04fb701cfb955f503rjung </listitem>
cfd9415521847b2f9394fad04fb701cfb955f503rjung </varlistentry>
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe <varlistentry>
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe <term><errorcode>EAI_NONAME</errorcode></term>
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe <listitem>
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe <para>
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe hostname or servname not provided, or not known
8491e0600f69b0405e156ea8a419653c065c645bcovener </para>
63b9f1f5880391261705f696d7d65507bbe9ace3covener </listitem>
63b9f1f5880391261705f696d7d65507bbe9ace3covener </varlistentry>
63b9f1f5880391261705f696d7d65507bbe9ace3covener <varlistentry>
49dacedb6c387b786b7911082ff35121a45f414bcovener <term><errorcode>EAI_SERVICE</errorcode></term>
49dacedb6c387b786b7911082ff35121a45f414bcovener <listitem>
49dacedb6c387b786b7911082ff35121a45f414bcovener <para>
49dacedb6c387b786b7911082ff35121a45f414bcovener servname not supported for <constant>ai_socktype</constant>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim </para>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim </listitem>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim </varlistentry>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim <varlistentry>
fc42512879dd0504532f52fe5d0d0383dda96a1eniq <term><errorcode>EAI_SOCKTYPE</errorcode></term>
fc42512879dd0504532f52fe5d0d0383dda96a1eniq <listitem>
fc42512879dd0504532f52fe5d0d0383dda96a1eniq <para><constant>ai_socktype</constant> not supported
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niq </para>
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niq </listitem>
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niq </varlistentry>
da0442c0440caef34706e2c2f3af05cb65921cc0jailletc <varlistentry>
983528026996668ea295be95aedb9c7a346af470ylavic <term><errorcode>EAI_SYSTEM</errorcode></term>
da0442c0440caef34706e2c2f3af05cb65921cc0jailletc <listitem>
da0442c0440caef34706e2c2f3af05cb65921cc0jailletc <para>
06b8f183140c8e02e0974e938a05078b511d1603covener system error returned in errno
06b8f183140c8e02e0974e938a05078b511d1603covener </para>
06b8f183140c8e02e0974e938a05078b511d1603covener </listitem>
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem </varlistentry>
259878293a997ff49f5ddfc53d3739cbdc25444ecovener </variablelist>
259878293a997ff49f5ddfc53d3739cbdc25444ecovener The message <errorname>invalid error code</errorname> is returned if
259878293a997ff49f5ddfc53d3739cbdc25444ecovener <parameter>ecode</parameter>
259878293a997ff49f5ddfc53d3739cbdc25444ecovener is out of range.
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem </para>
b54b024c06a19926832d77d40ba35ad8c41e4d3dminfrin <para><constant>ai_flags</constant>,
b54b024c06a19926832d77d40ba35ad8c41e4d3dminfrin <constant>ai_family</constant>
b54b024c06a19926832d77d40ba35ad8c41e4d3dminfrin and
65967d05f839dbf27cf91d91fa79585eeae19660minfrin <constant>ai_socktype</constant>
65967d05f839dbf27cf91d91fa79585eeae19660minfrin are elements of the
65967d05f839dbf27cf91d91fa79585eeae19660minfrin <type>struct addrinfo</type>
65967d05f839dbf27cf91d91fa79585eeae19660minfrin used by
8152945ae46857b170cb227e79bb799f4fc7710dminfrin <function>lwres_getaddrinfo()</function>.
8152945ae46857b170cb227e79bb799f4fc7710dminfrin </para>
8152945ae46857b170cb227e79bb799f4fc7710dminfrin </refsection>
8152945ae46857b170cb227e79bb799f4fc7710dminfrin
75f5c2db254c0167a0e396254460de09b775d203trawick <refsection><info><title>SEE ALSO</title></info>
75f5c2db254c0167a0e396254460de09b775d203trawick
75f5c2db254c0167a0e396254460de09b775d203trawick <para><citerefentry>
4f0358189bfa57b8e75bd6b94db264302a8f336amrumph <refentrytitle>strerror</refentrytitle><manvolnum>3</manvolnum>
4f0358189bfa57b8e75bd6b94db264302a8f336amrumph </citerefentry>,
4f0358189bfa57b8e75bd6b94db264302a8f336amrumph
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick <citerefentry>
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick <refentrytitle>lwres_getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick </citerefentry>,
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick
54d750a84a175d8e338880514d440773eb986b50covener <citerefentry>
54d750a84a175d8e338880514d440773eb986b50covener <refentrytitle>getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
54d750a84a175d8e338880514d440773eb986b50covener </citerefentry>,
54d750a84a175d8e338880514d440773eb986b50covener
54d750a84a175d8e338880514d440773eb986b50covener <citerefentry>
54d750a84a175d8e338880514d440773eb986b50covener <refentrytitle>RFC2133</refentrytitle>
54d750a84a175d8e338880514d440773eb986b50covener </citerefentry>.
54d750a84a175d8e338880514d440773eb986b50covener </para>
7a3aa12f0eda24793ee26d6a179bd53132e9dae8covener </refsection>
54d750a84a175d8e338880514d440773eb986b50covener</refentry>
54d750a84a175d8e338880514d440773eb986b50covener