Documentation Archive Developer
Search
ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



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_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_NONAME    hostname or servname not provided, or not known
           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-spe-cific implementation-specific
     cific error message string is returned.

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

     The include files <sys/types.h> and <sys/socket.h> are necessary.

SEE ALSO
     getaddrinfo(3), getnameinfo(3)

BSD                            December 20, 2004                           BSD