1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
3 [<!ENTITY mdash "—">]>
5 - Copyright (C) 2004, 2005, 2007, 2012 Internet Systems Consortium, Inc. ("ISC")
6 - Copyright (C) 2000, 2001 Internet Software Consortium.
8 - Permission to use, copy, modify, and/or distribute this software for any
9 - purpose with or without fee is hereby granted, provided that the above
10 - copyright notice and this permission notice appear in all copies.
12 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
13 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
14 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
15 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
16 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
17 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
18 - PERFORMANCE OF THIS SOFTWARE.
25 <date>Jun 30, 2000</date>
29 <refentrytitle>lwres_gai_strerror</refentrytitle>
30 <manvolnum>3</manvolnum>
31 <refmiscinfo>BIND9</refmiscinfo>
40 <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
45 <holder>Internet Software Consortium.</holder>
50 <refname>lwres_gai_strerror</refname>
51 <refpurpose>print suitable error string</refpurpose>
56 <funcsynopsisinfo>#include <lwres/netdb.h></funcsynopsisinfo>
60 <function>gai_strerror</function></funcdef>
61 <paramdef>int <parameter>ecode</parameter></paramdef>
67 <title>DESCRIPTION</title>
69 <para><function>lwres_gai_strerror()</function>
70 returns an error message corresponding to an error code returned by
71 <function>getaddrinfo()</function>.
72 The following error codes and their meaning are defined in
73 <filename>include/lwres/netdb.h</filename>.
76 <term><errorcode>EAI_ADDRFAMILY</errorcode></term>
79 address family for hostname not supported
84 <term><errorcode>EAI_AGAIN</errorcode></term>
87 temporary failure in name resolution
92 <term><errorcode>EAI_BADFLAGS</errorcode></term>
96 <constant>ai_flags</constant>
101 <term><errorcode>EAI_FAIL</errorcode></term>
104 non-recoverable failure in name resolution
109 <term><errorcode>EAI_FAMILY</errorcode></term>
111 <para><constant>ai_family</constant> not supported
116 <term><errorcode>EAI_MEMORY</errorcode></term>
119 memory allocation failure
124 <term><errorcode>EAI_NODATA</errorcode></term>
127 no address associated with hostname
132 <term><errorcode>EAI_NONAME</errorcode></term>
135 hostname or servname not provided, or not known
140 <term><errorcode>EAI_SERVICE</errorcode></term>
143 servname not supported for <constant>ai_socktype</constant>
148 <term><errorcode>EAI_SOCKTYPE</errorcode></term>
150 <para><constant>ai_socktype</constant> not supported
155 <term><errorcode>EAI_SYSTEM</errorcode></term>
158 system error returned in errno
163 The message <errorname>invalid error code</errorname> is returned if
164 <parameter>ecode</parameter>
167 <para><constant>ai_flags</constant>,
168 <constant>ai_family</constant>
170 <constant>ai_socktype</constant>
172 <type>struct addrinfo</type>
174 <function>lwres_getaddrinfo()</function>.
179 <title>SEE ALSO</title>
181 <refentrytitle>strerror</refentrytitle><manvolnum>3</manvolnum>
185 <refentrytitle>lwres_getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
189 <refentrytitle>getaddrinfo</refentrytitle><manvolnum>3</manvolnum>
193 <refentrytitle>RFC2133</refentrytitle>