netbsd man page for gai_strerror

GAI_STRERROR(3) 					   BSD 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)

BSD
								 February 22, 2006							       BSD