GAI_STRERROR(3XNET) X/Open Networking Services Library Functions


NAME


gai_strerror - address and name information error description

SYNOPSIS


cc [ flag ... ] file ... -lxnet [ library ... ]
#include <netdb.h>

const char *gai_strerror(int ecode);


DESCRIPTION


The gai_strerror() function returns a text string describing an error
value for the getaddrinfo(3XNET) and getnameinfo(3XNET) functions listed
in the <netdb.h> header.


When the ecode argument is one of the following values listed in the
<netdb.h> header:

EAI_AGAIN


EAI_BADFLAGS


EAI_FAIL


EAI_FAMILY


EAI_MEMORY


EAI_NONAME


EAI_SERVICE


EAI_SOCKTYPE


EAI_SYSTEM


the function return value points to a string describing the error. If the
argument is not one of those values, the function returns a pointer to a
string whose contents indicate an unknown error.

RETURN VALUES


Upon successful completion, gai_strerror() returns a pointer to a string
describing the error value.

ERRORS


No errors are defined.

ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


getaddrinfo(3XNET), getnameinfo(3XNET), attributes(5), standards(5)


December 1, 2003 GAI_STRERROR(3XNET)