gai_strerror()
Return the string associated with a getaddrinfo() error code
Synopsis:
#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>
const char * gai_strerror( int ecode );
Arguments:
- ecode
- The error code number from the getaddrinfo() function.
Library:
libsocket
Use the -l socket option to qcc to link against this library.
Description:
The gai_strerror() function returns a string describing the error code from the getaddrinfo() function. Nonzero error codes are defined in <netdb.h> as follows:
- EAI_ADDRFAMILY
- The address family for nodename isn't supported.
- EAI_AGAIN
- There was a temporary failure in name resolution.
- EAI_BADFLAGS
- Invalid value for ai_flags.
- EAI_FAIL
- Nonrecoverable failure in name resolution.
- EAI_FAMILY
- The ai_family isn't supported.
- EAI_MEMORY
- Memory allocation failure.
- EAI_NODATA
- No address associated with the nodename.
- EAI_NONAME
- Either the nodename or the servname argument wasn't provided or isn't known.
- EAI_SERVICE
- The servname argument isn't supported for ai_socktype.
- EAI_SOCKTYPE
- The ai_socktype isn't supported.
- EAI_SYSTEM
- System error returned in errno.
Returns:
If called with a proper ecode argument, a pointer to a string describing the given error code. If the argument isn't one of the EAI_* values, a pointer to a string whose contents indicate an unknown error.
Note:
Don't modify the strings that this function returns.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | Yes |
| Signal handler | Yes |
| Thread | Yes |
Page updated: