9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews/*
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * Copyright (C) 2009, 2014, 2016 Internet Systems Consortium, Inc. ("ISC")
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews *
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * This Source Code Form is subject to the terms of the Mozilla Public
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * License, v. 2.0. If a copy of the MPL was not distributed with this
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * file, You can obtain one at http://mozilla.org/MPL/2.0/.
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews */
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews/* $Id: gai_strerror.c,v 1.5 2009/09/02 23:48:02 tbox Exp $ */
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews/*! \file gai_strerror.c
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * gai_strerror() returns an error message corresponding to an
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * error code returned by getaddrinfo() and getnameinfo(). The following error
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * codes and their meaning are defined in
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \link netdb.h include/irs/netdb.h.\endlink
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * This implementation is almost an exact copy of lwres/gai_sterror.c except
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * that it catches up the latest API standard, RFC3493.
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews *
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_ADDRFAMILY address family for hostname not supported
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_AGAIN temporary failure in name resolution
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_BADFLAGS invalid value for ai_flags
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_FAIL non-recoverable failure in name resolution
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_FAMILY ai_family not supported
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_MEMORY memory allocation failure
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_NODATA no address associated with hostname (obsoleted in RFC3493)
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_NONAME hostname nor servname provided, or not known
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_SERVICE servname not supported for ai_socktype
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_SOCKTYPE ai_socktype not supported
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_SYSTEM system error returned in errno
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_BADHINTS Invalid value for hints (non-standard)
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_PROTOCOL Resolved protocol is unknown (non-standard)
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_OVERFLOW Argument buffer overflow
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * \li #EAI_INSECUREDATA Insecure Data (experimental)
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews *
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * The message invalid error code is returned if ecode is out of range.
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews *
9db88ce113701a6fb600a67aaa65764d800e25b0Mark Andrews * ai_flags, ai_family and ai_socktype are elements of the struct
* addrinfo used by lwres_getaddrinfo().
*
* \section gai_strerror_see See Also
*
* strerror(), getaddrinfo(), getnameinfo(), RFC3493.
*/
#include <config.h>
#include <isc/net.h>
#include <irs/netdb.h>
/*% Text of error messages. */
static const char *gai_messages[] = {
"no error",
"address family for hostname not supported",
"temporary failure in name resolution",
"invalid value for ai_flags",
"non-recoverable failure in name resolution",
"ai_family not supported",
"memory allocation failure",
"no address associated with hostname",
"hostname nor servname provided, or not known",
"servname not supported for ai_socktype",
"ai_socktype not supported",
"system error returned in errno",
"bad hints",
"bad protocol",
"argument buffer overflow",
"insecure data provided"
};
/*%
* Returns an error message corresponding to an error code returned by
* getaddrinfo() and getnameinfo()
*/
IRS_GAISTRERROR_RETURN_T
gai_strerror(int ecode) {
union {
const char *const_ptr;
char *deconst_ptr;
} ptr;
if ((ecode < 0) ||
(ecode >= (int)(sizeof(gai_messages)/sizeof(*gai_messages))))
ptr.const_ptr = "invalid error code";
else
ptr.const_ptr = gai_messages[ecode];
return (ptr.deconst_ptr);
}