294 lines
4.0 KiB
HTML
294 lines
4.0 KiB
HTML
<!--
|
|
- Copyright (C) 2000, 2001 Internet Software Consortium.
|
|
-
|
|
- Permission to use, copy, modify, and distribute this software for any
|
|
- purpose with or without fee is hereby granted, provided that the above
|
|
- copyright notice and this permission notice appear in all copies.
|
|
-
|
|
- THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
|
|
- DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
|
|
- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
|
|
- INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
- INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
|
|
- FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
|
|
- NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
|
|
- WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>lwres_gai_strerror</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
|
|
"></HEAD
|
|
><BODY
|
|
CLASS="REFENTRY"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><H1
|
|
><A
|
|
NAME="AEN1"
|
|
>lwres_gai_strerror</A
|
|
></H1
|
|
><DIV
|
|
CLASS="REFNAMEDIV"
|
|
><A
|
|
NAME="AEN8"
|
|
></A
|
|
><H2
|
|
>Name</H2
|
|
>gai_strerror -- print suitable error string</DIV
|
|
><DIV
|
|
CLASS="REFSYNOPSISDIV"
|
|
><A
|
|
NAME="AEN11"
|
|
></A
|
|
><H2
|
|
>Synopsis</H2
|
|
><DIV
|
|
CLASS="FUNCSYNOPSIS"
|
|
><A
|
|
NAME="AEN12"
|
|
></A
|
|
><P
|
|
></P
|
|
><PRE
|
|
CLASS="FUNCSYNOPSISINFO"
|
|
>#include <lwres/netdb.h></PRE
|
|
><P
|
|
><CODE
|
|
><CODE
|
|
CLASS="FUNCDEF"
|
|
>char *
|
|
gai_strerror</CODE
|
|
>(int ecode);</CODE
|
|
></P
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN18"
|
|
></A
|
|
><H2
|
|
>DESCRIPTION</H2
|
|
><P
|
|
><TT
|
|
CLASS="FUNCTION"
|
|
>lwres_gai_strerror()</TT
|
|
>
|
|
returns an error message corresponding to an error code returned by
|
|
<TT
|
|
CLASS="FUNCTION"
|
|
>getaddrinfo()</TT
|
|
>.
|
|
The following error codes and their meaning are defined in
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>include/lwres/netdb.h</TT
|
|
>.
|
|
<P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
><SPAN
|
|
CLASS="ERRORCODE"
|
|
>EAI_ADDRFAMILY</SPAN
|
|
></DT
|
|
><DD
|
|
><P
|
|
>address family for hostname not supported</P
|
|
></DD
|
|
><DT
|
|
><SPAN
|
|
CLASS="ERRORCODE"
|
|
>EAI_AGAIN</SPAN
|
|
></DT
|
|
><DD
|
|
><P
|
|
>temporary failure in name resolution</P
|
|
></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
|
|
> |