NAME
gai_strerror
—
get error message string from EAI_xxx
error code
LIBRARY
library “libc”
SYNOPSIS
#include
<sys/types.h>
#include <sys/socket.h>
#include <netdb.h>
const char *
gai_strerror
(int
ecode);
DESCRIPTION
Thegai_strerror
()
function returns an error message string corresponding to the error code
returned by
getaddrinfo(3) or
getnameinfo(3).
The following error codes and their meaning are defined in
<netdb.h>
:
EAI_ADDRFAMILY
- address family for hostname not supported
EAI_AGAIN
- temporary failure in name resolution
EAI_BADFLAGS
- invalid value for ai_flags
EAI_BADHINTS
- invalid value for hints
EAI_FAIL
- non-recoverable failure in name resolution
EAI_FAMILY
- ai_family not supported
EAI_MEMORY
- memory allocation failure
EAI_NODATA
- no address associated with hostname
EAI_NONAME
- hostname or servname not provided, or not known
EAI_OVERFLOW
- argument buffer overflow
EAI_PROTOCOL
- resolved protocol is unknown
EAI_SERVICE
- servname not supported for ai_socktype
EAI_SOCKTYPE
- ai_socktype not supported
EAI_SYSTEM
- system error returned in errno
RETURN VALUES
The gai_strerror
() function returns a
pointer to the error message string corresponding to
ecode. If ecode is out of range,
an implementation-specific error message string is returned.