unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (NetBSD-6.1.5)
Page:
Section:
Apropos / Subsearch:
optional field

GAI_STRERROR(3)            Library Functions Manual            GAI_STRERROR(3)

NAME
     gai_strerror -- get error message string from EAI_xxx error code

SYNOPSIS
     #include <&lt;sys/types.h>&gt;
     #include <&lt;sys/socket.h>&gt;
     #include <&lt;netdb.h>&gt;

     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)

NetBSD 6.1.5                   February 22, 2006                  NetBSD 6.1.5