lwres_gai_strerror.html revision 841179549b6433e782c164a562eb3422f603533d
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz<!--
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz - Copyright (C) 2000, 2001 Internet Software Consortium.
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz -
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz - Permission to use, copy, modify, and distribute this software for any
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz - purpose with or without fee is hereby granted, provided that the above
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz - copyright notice and this permission notice appear in all copies.
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd -
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd-->
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd<!-- $Id: lwres_gai_strerror.html,v 1.3 2001/06/08 19:32:26 gson Exp $ -->
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd<HTML
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><HEAD
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><TITLE
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd>lwres_gai_strerror</TITLE
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd><META
3b3b7fc78d1f5bfc2769903375050048ff41ff26ndNAME="GENERATOR"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndCONTENT="Modular DocBook HTML Stylesheet Version 1.61
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd"></HEAD
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><BODY
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndCLASS="REFENTRY"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndBGCOLOR="#FFFFFF"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndTEXT="#000000"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndLINK="#0000FF"
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantzVLINK="#840084"
aa0b2780958e9b1467c9d0153a05738e399811a5ndALINK="#0000FF"
aa0b2780958e9b1467c9d0153a05738e399811a5nd><H1
aa0b2780958e9b1467c9d0153a05738e399811a5nd><A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndNAME="AEN1"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>lwres_gai_strerror</A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd></H1
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><DIV
117c1f888a14e73cdd821dc6c23eb0411144a41cndCLASS="REFNAMEDIV"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndNAME="AEN8"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd></A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><H2
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>Name</H2
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>gai_strerror&nbsp;--&nbsp;print suitable error string</DIV
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><DIV
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndCLASS="REFSYNOPSISDIV"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndNAME="AEN11"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd></A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><H2
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>Synopsis</H2
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><DIV
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndCLASS="FUNCSYNOPSIS"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndNAME="AEN12"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd></A
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz><P
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz></P
aa0b2780958e9b1467c9d0153a05738e399811a5nd><PRE
aa0b2780958e9b1467c9d0153a05738e399811a5ndCLASS="FUNCSYNOPSISINFO"
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz>#include &lt;lwres/netdb.h&gt;</PRE
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz><P
aa0b2780958e9b1467c9d0153a05738e399811a5nd><CODE
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz><CODE
aa0b2780958e9b1467c9d0153a05738e399811a5ndCLASS="FUNCDEF"
aa0b2780958e9b1467c9d0153a05738e399811a5nd>char *
aa0b2780958e9b1467c9d0153a05738e399811a5ndgai_strerror</CODE
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz>(int ecode);</CODE
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz></P
aa0b2780958e9b1467c9d0153a05738e399811a5nd><P
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz></P
aa0b2780958e9b1467c9d0153a05738e399811a5nd></DIV
aa0b2780958e9b1467c9d0153a05738e399811a5nd></DIV
aa0b2780958e9b1467c9d0153a05738e399811a5nd><DIV
aa0b2780958e9b1467c9d0153a05738e399811a5ndCLASS="REFSECT1"
aa0b2780958e9b1467c9d0153a05738e399811a5nd><A
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantzNAME="AEN18"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd></A
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><H2
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>DESCRIPTION</H2
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><P
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><TT
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndCLASS="FUNCTION"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>lwres_gai_strerror()</TT
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndreturns an error message corresponding to an error code returned by
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd<TT
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndCLASS="FUNCTION"
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>getaddrinfo()</TT
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>.
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndThe following error codes and their meaning are defined in
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz<TT
aa0b2780958e9b1467c9d0153a05738e399811a5ndCLASS="FILENAME"
aa0b2780958e9b1467c9d0153a05738e399811a5nd>include/lwres/netdb.h</TT
aa0b2780958e9b1467c9d0153a05738e399811a5nd>.
aa0b2780958e9b1467c9d0153a05738e399811a5nd<P
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz></P
aa0b2780958e9b1467c9d0153a05738e399811a5nd><DIV
aa0b2780958e9b1467c9d0153a05738e399811a5ndCLASS="VARIABLELIST"
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz><DL
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz><DT
f43ed9051a7f4db461d67ed4f7ece175b3dbca7cjerenkrantz><SPAN
aa0b2780958e9b1467c9d0153a05738e399811a5ndCLASS="ERRORCODE"
aa0b2780958e9b1467c9d0153a05738e399811a5nd>EAI_ADDRFAMILY</SPAN
aa0b2780958e9b1467c9d0153a05738e399811a5nd></DT
aa0b2780958e9b1467c9d0153a05738e399811a5nd><DD
aa0b2780958e9b1467c9d0153a05738e399811a5nd><P
aa0b2780958e9b1467c9d0153a05738e399811a5nd>address family for hostname not supported</P
aa0b2780958e9b1467c9d0153a05738e399811a5nd></DD
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><DT
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><SPAN
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4ndCLASS="ERRORCODE"
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd>EAI_AGAIN</SPAN
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd></DT
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd><DD
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd><P
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd>temporary failure in name resolution</P
bdd978e5ecd8daa2542d4d4e1988c78a622cd7f4nd></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_BADFLAGS</SPAN
></DT
><DD
><P
>invalid value for
<TT
CLASS="CONSTANT"
>ai_flags</TT
></P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_FAIL</SPAN
></DT
><DD
><P
>non-recoverable failure in name resolution</P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_FAMILY</SPAN
></DT
><DD
><P
><TT
CLASS="CONSTANT"
>ai_family</TT
>
not supported</P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_MEMORY</SPAN
></DT
><DD
><P
>memory allocation failure</P
></DD
><DT
><SPAN
CLASS="ERRORCODE"
>EAI_NODATA</SPAN
></DT
><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
>