gai_strerror(3XNET)

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also

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)

SunOS 5.10  Last Revised 1 Dec 2003

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also