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(7) for descriptions of the following attributes:


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

SEE ALSO

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

December 1, 2003 GAI_STRERROR(3XNET)