Go to main content

man pages section 3: Networking Library Functions

Exit Print View

Updated: July 2017
 
 

gai_strerror(3XNET)

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
Committed
MT-Level
MT-Safe
Standard

See Also

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