Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	   Name could not be resolved at this time
	   EAI_BADFLAGS    flags parameter had an invalid value
	   EAI_BADHINTS    invalid value for hints
	   EAI_FAIL	   Non-recoverable failure in name resolution
	   EAI_FAMILY	   Address family was not recognized
	   EAI_MEMORY	   Memory allocation failure
	   EAI_NODATA	   No address associated with hostname
	   EAI_NONAME	   Name does not resolve
	   EAI_OVERFLOW    argument buffer overflow
	   EAI_PROTOCOL    Resolved protocol is unknown
	   EAI_SERVICE	   Service was not recognized for socket type
	   EAI_SOCKTYPE    Intended socket type was not recognized
	   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-spe-
     cific error message string is returned.

SEE ALSO
     getaddrinfo(3), getnameinfo(3)

STANDARDS
     RFC 3493  Basic Socket Interface Extensions for IPv6

     EAI_ADDRFAMILY and EAI_NODATA were in previous RFCs, but not in  RFC  3493.
     They  are not in POSIX (IEEE Std 1003.1-2017).  They were in FreeBSD before
     5.2, and were re-added for 14.0.  EAI_BADHINTS, EAI_OVERFLOW, and	EAI_PRO-
     TOCOL are not in RFC 3493 or POSIX.

FreeBSD 14.3			November 2, 2022		 GAI_STRERROR(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gai_strerror&sektion=3&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help