GAI_STRERROR(3)

GAI_STRERROR(3) | Library Functions Manual | GAI_STRERROR(3)

# NAME

gai_strerror — get error message string from EAI_xxx error code

# SYNOPSIS

#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>

const char *
gai_strerror(int ecode);

# DESCRIPTION

The gai_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

gai_strerror() 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.

# SEE ALSO

getaddrinfo(3), getnameinfo(3)

February 22, 2006 | NetBSD 5.99