lwres_gai_strerror.html revision 474a81662f79f5d6c3c68737d0a76c775552025c
12494N/A<!--
12494N/A - Copyright (C) 2000, 2001 Internet Software Consortium.
12494N/A -
12494N/A - Permission to use, copy, modify, and distribute this software for any
12494N/A - purpose with or without fee is hereby granted, provided that the above
12494N/A - copyright notice and this permission notice appear in all copies.
12494N/A -
12494N/A - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
12494N/A - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
12494N/A - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
12494N/A - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
12494N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
16855N/A - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
12494N/A - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
12494N/A - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
12494N/A-->
12494N/A<HTML
16793N/A><HEAD
12494N/A><TITLE
12494N/A>lwres_gai_strerror</TITLE
12494N/A><META
12494N/ANAME="GENERATOR"
15183N/ACONTENT="Modular DocBook HTML Stylesheet Version 1.61
16353N/A"></HEAD
12519N/A><BODY
12961N/ACLASS="REFENTRY"
12961N/ABGCOLOR="#FFFFFF"
16445N/ATEXT="#000000"
16229N/ALINK="#0000FF"
16445N/AVLINK="#840084"
16390N/AALINK="#0000FF"
16596N/A><H1
16504N/A><A
16855N/ANAME="AEN1"
16855N/A>lwres_gai_strerror</A
12494N/A></H1
12494N/A><DIV
12494N/ACLASS="REFNAMEDIV"
12519N/A><A
12961N/ANAME="AEN8"
16229N/A></A
16390N/A><H2
16504N/A>Name</H2
16855N/A>gai_strerror&nbsp;--&nbsp;print suitable error string</DIV
12494N/A><DIV
12494N/ACLASS="REFSYNOPSISDIV"
12494N/A><A
12494N/ANAME="AEN11"
12494N/A></A
12494N/A><H2
12494N/A>Synopsis</H2
12494N/A><DIV
12494N/ACLASS="FUNCSYNOPSIS"
12494N/A><A
12494N/ANAME="AEN12"
12494N/A></A
12495N/A><P
13796N/A></P
13796N/A><PRE
12495N/ACLASS="FUNCSYNOPSISINFO"
12495N/A>#include &lt;lwres/netdb.h&gt;</PRE
12494N/A><P
12494N/A><CODE
12494N/A><CODE
12494N/ACLASS="FUNCDEF"
12494N/A>char *
12494N/Agai_strerror</CODE
12494N/A>(int ecode);</CODE
12494N/A></P
12494N/A><P
12494N/A></P
12494N/A></DIV
12494N/A></DIV
12494N/A><DIV
12494N/ACLASS="REFSECT1"
16850N/A><A
16850N/ANAME="AEN18"
16801N/A></A
16801N/A><H2
16668N/A>DESCRIPTION</H2
16668N/A><P
16647N/A><TT
16647N/ACLASS="FUNCTION"
16596N/A>lwres_gai_strerror()</TT
16596N/A>
16504N/Areturns an error message corresponding to an error code returned by
16504N/A<TT
16390N/ACLASS="FUNCTION"
16390N/A>getaddrinfo()</TT
16390N/A>.
16372N/AThe following error codes and their meaning are defined in
16372N/A<TT
16229N/ACLASS="FILENAME"
16229N/A>include/lwres/netdb.h</TT
16159N/A>.
16159N/A<P
16144N/A></P
16144N/A><DIV
16037N/ACLASS="VARIABLELIST"
16037N/A><DL
16037N/A><DT
15866N/A><SPAN
15866N/ACLASS="ERRORCODE"
15755N/A>EAI_ADDRFAMILY</SPAN
15755N/A></DT
15614N/A><DD
15614N/A><P
15588N/A>address family for hostname not supported</P
15588N/A></DD
15588N/A><DT
15579N/A><SPAN
15579N/ACLASS="ERRORCODE"
15448N/A>EAI_AGAIN</SPAN
15448N/A></DT
14537N/A><DD
14537N/A><P
14451N/A>temporary failure in name resolution</P
14451N/A></DD
14451N/A><DT
14269N/A><SPAN
14269N/ACLASS="ERRORCODE"
14108N/A>EAI_BADFLAGS</SPAN
14108N/A></DT
13938N/A><DD
13938N/A><P
13871N/A>invalid value for
13871N/A<TT
13871N/ACLASS="CONSTANT"
13796N/A>ai_flags</TT
13796N/A></P
13796N/A></DD
13796N/A><DT
13796N/A><SPAN
13655N/ACLASS="ERRORCODE"
13655N/A>EAI_FAIL</SPAN
13622N/A></DT
13622N/A><DD
13503N/A><P
13503N/A>non-recoverable failure in name resolution</P
13473N/A></DD
13473N/A><DT
13324N/A><SPAN
13324N/ACLASS="ERRORCODE"
13114N/A>EAI_FAMILY</SPAN
13114N/A></DT
12961N/A><DD
12961N/A><P
12812N/A><TT
12812N/ACLASS="CONSTANT"
12720N/A>ai_family</TT
12720N/A> not supported</P
12678N/A></DD
12678N/A><DT
12537N/A><SPAN
12537N/ACLASS="ERRORCODE"
12519N/A>EAI_MEMORY</SPAN
12519N/A></DT
12495N/A><DD
12495N/A><P
12494N/A>memory allocation failure</P
12494N/A></DD
12494N/A><DT
12494N/A><SPAN
12494N/ACLASS="ERRORCODE"
12494N/A>EAI_NODATA</SPAN
12494N/A></DT
12494N/A><DD
><P
>no address associated with hostname</P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_NONAME</SPAN
></DT
><DD
><P
>hostname or servname not provided, or not known</P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_SERVICE</SPAN
></DT
><DD
><P
>servname not supported for <TT
CLASS="CONSTANT"
>ai_socktype</TT
></P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_SOCKTYPE</SPAN
></DT
><DD
><P
><TT
CLASS="CONSTANT"
>ai_socktype</TT
> not supported</P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_SYSTEM</SPAN
></DT
><DD
><P
>system error returned in errno</P
></DD
></DL
></DIV
>
The message <SPAN
CLASS="ERRORNAME"
>invalid error code</SPAN
> is returned if
<TT
CLASS="PARAMETER"
><I
>ecode</I
></TT
>
is out of range.</P
><P
><TT
CLASS="CONSTANT"
>ai_flags</TT
>,
<TT
CLASS="CONSTANT"
>ai_family</TT
>
and
<TT
CLASS="CONSTANT"
>ai_socktype</TT
>
are elements of the
<SPAN
CLASS="TYPE"
>struct addrinfo</SPAN
>
used by
<TT
CLASS="FUNCTION"
>lwres_getaddrinfo()</TT
>.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN92"
></A
><H2
>SEE ALSO</H2
><P
><SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>strerror</SPAN
>(3)</SPAN
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>lwres_getaddrinfo</SPAN
>(3)</SPAN
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>getaddrinfo</SPAN
>(3)</SPAN
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>RFC2133</SPAN
></SPAN
>.</P
></DIV
></BODY
></HTML
>