lwres_gai_strerror.html revision 61e1dc26d62c2a0059e3ca7efe2ad0f4a5b8df92
2765a47c64de85888aa0aaa11a447253d2c32327is<!--
2765a47c64de85888aa0aaa11a447253d2c32327is - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
2765a47c64de85888aa0aaa11a447253d2c32327is - Copyright (C) 2001 Internet Software Consortium.
2765a47c64de85888aa0aaa11a447253d2c32327is -
2765a47c64de85888aa0aaa11a447253d2c32327is - Permission to use, copy, modify, and distribute this software for any
2765a47c64de85888aa0aaa11a447253d2c32327is - purpose with or without fee is hereby granted, provided that the above
2765a47c64de85888aa0aaa11a447253d2c32327is - copyright notice and this permission notice appear in all copies.
2765a47c64de85888aa0aaa11a447253d2c32327is -
2765a47c64de85888aa0aaa11a447253d2c32327is - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
2765a47c64de85888aa0aaa11a447253d2c32327is - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
2765a47c64de85888aa0aaa11a447253d2c32327is - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
2765a47c64de85888aa0aaa11a447253d2c32327is - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
2765a47c64de85888aa0aaa11a447253d2c32327is - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
2765a47c64de85888aa0aaa11a447253d2c32327is - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
2765a47c64de85888aa0aaa11a447253d2c32327is - PERFORMANCE OF THIS SOFTWARE.
2765a47c64de85888aa0aaa11a447253d2c32327is-->
2765a47c64de85888aa0aaa11a447253d2c32327is
2765a47c64de85888aa0aaa11a447253d2c32327is<!-- $Id: lwres_gai_strerror.html,v 1.8 2004/04/07 00:57:02 marka Exp $ -->
2765a47c64de85888aa0aaa11a447253d2c32327is
2765a47c64de85888aa0aaa11a447253d2c32327is<HTML
2765a47c64de85888aa0aaa11a447253d2c32327is><HEAD
2765a47c64de85888aa0aaa11a447253d2c32327is><TITLE
2765a47c64de85888aa0aaa11a447253d2c32327is>lwres_gai_strerror</TITLE
2765a47c64de85888aa0aaa11a447253d2c32327is><META
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="GENERATOR"
2765a47c64de85888aa0aaa11a447253d2c32327isCONTENT="Modular DocBook HTML Stylesheet Version 1.73
2765a47c64de85888aa0aaa11a447253d2c32327is"></HEAD
2765a47c64de85888aa0aaa11a447253d2c32327is><BODY
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFENTRY"
2765a47c64de85888aa0aaa11a447253d2c32327isBGCOLOR="#FFFFFF"
2765a47c64de85888aa0aaa11a447253d2c32327isTEXT="#000000"
2765a47c64de85888aa0aaa11a447253d2c32327isLINK="#0000FF"
2765a47c64de85888aa0aaa11a447253d2c32327isVLINK="#840084"
2765a47c64de85888aa0aaa11a447253d2c32327isALINK="#0000FF"
2765a47c64de85888aa0aaa11a447253d2c32327is><H1
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN1"
2765a47c64de85888aa0aaa11a447253d2c32327is>lwres_gai_strerror</A
2765a47c64de85888aa0aaa11a447253d2c32327is></H1
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFNAMEDIV"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN8"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><H2
2765a47c64de85888aa0aaa11a447253d2c32327is>Name</H2
2765a47c64de85888aa0aaa11a447253d2c32327is>gai_strerror&nbsp;--&nbsp;print suitable error string</DIV
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFSYNOPSISDIV"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN11"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><H2
2765a47c64de85888aa0aaa11a447253d2c32327is>Synopsis</H2
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="FUNCSYNOPSIS"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN12"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is></P
2765a47c64de85888aa0aaa11a447253d2c32327is><PRE
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="FUNCSYNOPSISINFO"
2765a47c64de85888aa0aaa11a447253d2c32327is>#include &lt;lwres/netdb.h&gt;</PRE
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is><CODE
2765a47c64de85888aa0aaa11a447253d2c32327is><CODE
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="FUNCDEF"
2765a47c64de85888aa0aaa11a447253d2c32327is>char *
2765a47c64de85888aa0aaa11a447253d2c32327isgai_strerror</CODE
2765a47c64de85888aa0aaa11a447253d2c32327is>(int ecode);</CODE
2765a47c64de85888aa0aaa11a447253d2c32327is></P
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is></P
2765a47c64de85888aa0aaa11a447253d2c32327is></DIV
2765a47c64de85888aa0aaa11a447253d2c32327is></DIV
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFSECT1"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN18"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><H2
2765a47c64de85888aa0aaa11a447253d2c32327is>DESCRIPTION</H2
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is><TT
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="FUNCTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>lwres_gai_strerror()</TT
2765a47c64de85888aa0aaa11a447253d2c32327is>
2765a47c64de85888aa0aaa11a447253d2c32327isreturns an error message corresponding to an error code returned by
2765a47c64de85888aa0aaa11a447253d2c32327is<TT
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="FUNCTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>getaddrinfo()</TT
2765a47c64de85888aa0aaa11a447253d2c32327is>.
2765a47c64de85888aa0aaa11a447253d2c32327isThe following error codes and their meaning are defined in
2765a47c64de85888aa0aaa11a447253d2c32327is<TT
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="FILENAME"
2765a47c64de85888aa0aaa11a447253d2c32327is>include/lwres/netdb.h</TT
2765a47c64de85888aa0aaa11a447253d2c32327is>.
2765a47c64de85888aa0aaa11a447253d2c32327is<P
2765a47c64de85888aa0aaa11a447253d2c32327is></P
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="VARIABLELIST"
2765a47c64de85888aa0aaa11a447253d2c32327is><DL
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_ADDRFAMILY</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>address family for hostname not supported</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_AGAIN</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>temporary failure in name resolution</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_BADFLAGS</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>invalid value for
2765a47c64de85888aa0aaa11a447253d2c32327is<TT
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="CONSTANT"
2765a47c64de85888aa0aaa11a447253d2c32327is>ai_flags</TT
2765a47c64de85888aa0aaa11a447253d2c32327is></P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_FAIL</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>non-recoverable failure in name resolution</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_FAMILY</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is><TT
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="CONSTANT"
2765a47c64de85888aa0aaa11a447253d2c32327is>ai_family</TT
2765a47c64de85888aa0aaa11a447253d2c32327is> not supported</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_MEMORY</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>memory allocation failure</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_NODATA</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>no address associated with hostname</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_NONAME</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>hostname or servname not provided, or not known</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="ERRORCODE"
2765a47c64de85888aa0aaa11a447253d2c32327is>EAI_SERVICE</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is>servname not supported for <TT
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="CONSTANT"
2765a47c64de85888aa0aaa11a447253d2c32327is>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
>