295 lines
		
	
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			295 lines
		
	
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* Provide a netdb.h header file for systems lacking it (read: MinGW).
 | 
						|
   Copyright (C) 2008-2023 Free Software Foundation, Inc.
 | 
						|
   Written by Simon Josefsson.
 | 
						|
 | 
						|
   This file is free software: you can redistribute it and/or modify
 | 
						|
   it under the terms of the GNU Lesser General Public License as
 | 
						|
   published by the Free Software Foundation; either version 2.1 of the
 | 
						|
   License, or (at your option) any later version.
 | 
						|
 | 
						|
   This file is distributed in the hope that it will be useful,
 | 
						|
   but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
						|
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
						|
   GNU Lesser General Public License for more details.
 | 
						|
 | 
						|
   You should have received a copy of the GNU Lesser General Public License
 | 
						|
   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 | 
						|
 | 
						|
/* This file is supposed to be used on platforms that lack <netdb.h>.
 | 
						|
   It is intended to provide definitions and prototypes needed by an
 | 
						|
   application.  */
 | 
						|
 | 
						|
#ifndef _@GUARD_PREFIX@_NETDB_H
 | 
						|
 | 
						|
#if __GNUC__ >= 3
 | 
						|
@PRAGMA_SYSTEM_HEADER@
 | 
						|
#endif
 | 
						|
@PRAGMA_COLUMNS@
 | 
						|
 | 
						|
#if @HAVE_NETDB_H@
 | 
						|
 | 
						|
/* The include_next requires a split double-inclusion guard.  */
 | 
						|
# @INCLUDE_NEXT@ @NEXT_NETDB_H@
 | 
						|
 | 
						|
#endif
 | 
						|
 | 
						|
#ifndef _@GUARD_PREFIX@_NETDB_H
 | 
						|
#define _@GUARD_PREFIX@_NETDB_H
 | 
						|
 | 
						|
/* Get <netdb.h> definitions such as 'socklen_t' on IRIX 6.5 and OSF/1 4.0 and
 | 
						|
   'struct hostent' on MinGW.  */
 | 
						|
#include <sys/socket.h>
 | 
						|
 | 
						|
/* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
 | 
						|
 | 
						|
/* The definition of _GL_ARG_NONNULL is copied here.  */
 | 
						|
 | 
						|
/* The definition of _GL_WARN_ON_USE is copied here.  */
 | 
						|
 | 
						|
/* Declarations for a platform that lacks <netdb.h>, or where it is
 | 
						|
   incomplete.  */
 | 
						|
 | 
						|
#if @GNULIB_GETADDRINFO@
 | 
						|
 | 
						|
# if !@HAVE_STRUCT_ADDRINFO@
 | 
						|
 | 
						|
#  ifdef __cplusplus
 | 
						|
extern "C" {
 | 
						|
#  endif
 | 
						|
 | 
						|
#  if !GNULIB_defined_struct_addrinfo
 | 
						|
/* Structure to contain information about address of a service provider.  */
 | 
						|
struct addrinfo
 | 
						|
{
 | 
						|
  int ai_flags;                 /* Input flags.  */
 | 
						|
  int ai_family;                /* Protocol family for socket.  */
 | 
						|
  int ai_socktype;              /* Socket type.  */
 | 
						|
  int ai_protocol;              /* Protocol for socket.  */
 | 
						|
  socklen_t ai_addrlen;         /* Length of socket address.  */
 | 
						|
  struct sockaddr *ai_addr;     /* Socket address for socket.  */
 | 
						|
  char *ai_canonname;           /* Canonical name for service location.  */
 | 
						|
  struct addrinfo *ai_next;     /* Pointer to next in list.  */
 | 
						|
};
 | 
						|
#   define GNULIB_defined_struct_addrinfo 1
 | 
						|
#  endif
 | 
						|
 | 
						|
#  ifdef __cplusplus
 | 
						|
}
 | 
						|
#  endif
 | 
						|
 | 
						|
# endif
 | 
						|
 | 
						|
/* Possible values for 'ai_flags' field in 'addrinfo' structure.  */
 | 
						|
# ifndef AI_PASSIVE
 | 
						|
#  define AI_PASSIVE    0x0001  /* Socket address is intended for 'bind'.  */
 | 
						|
# endif
 | 
						|
# ifndef AI_CANONNAME
 | 
						|
#  define AI_CANONNAME  0x0002  /* Request for canonical name.  */
 | 
						|
# endif
 | 
						|
# ifndef AI_NUMERICSERV
 | 
						|
#  define AI_NUMERICSERV        0x0400  /* Don't use name resolution.  */
 | 
						|
# endif
 | 
						|
 | 
						|
# if 0
 | 
						|
#  define AI_NUMERICHOST        0x0004  /* Don't use name resolution.  */
 | 
						|
# endif
 | 
						|
 | 
						|
/* These symbolic constants are required to be present by POSIX, but
 | 
						|
   our getaddrinfo replacement doesn't use them (yet).  Setting them
 | 
						|
   to 0 on systems that doesn't have them avoids causing problems for
 | 
						|
   system getaddrinfo implementations that would be confused by
 | 
						|
   unknown values.  */
 | 
						|
# ifndef AI_V4MAPPED
 | 
						|
#  define AI_V4MAPPED    0 /* 0x0008: IPv4 mapped addresses are acceptable.  */
 | 
						|
# endif
 | 
						|
# ifndef AI_ALL
 | 
						|
#  define AI_ALL         0 /* 0x0010: Return IPv4 mapped and IPv6 addresses. */
 | 
						|
# endif
 | 
						|
# ifndef AI_ADDRCONFIG
 | 
						|
#  define AI_ADDRCONFIG  0 /* 0x0020: Use configuration of this host to choose
 | 
						|
                                      returned address type.  */
 | 
						|
# endif
 | 
						|
 | 
						|
/* Error values for 'getaddrinfo' function.  */
 | 
						|
# ifndef EAI_BADFLAGS
 | 
						|
#  define EAI_BADFLAGS    -1    /* Invalid value for 'ai_flags' field.  */
 | 
						|
#  define EAI_NONAME      -2    /* NAME or SERVICE is unknown.  */
 | 
						|
#  define EAI_AGAIN       -3    /* Temporary failure in name resolution.  */
 | 
						|
#  define EAI_FAIL        -4    /* Non-recoverable failure in name res.  */
 | 
						|
#  define EAI_NODATA      -5    /* No address associated with NAME.  */
 | 
						|
#  define EAI_FAMILY      -6    /* 'ai_family' not supported.  */
 | 
						|
#  define EAI_SOCKTYPE    -7    /* 'ai_socktype' not supported.  */
 | 
						|
#  define EAI_SERVICE     -8    /* SERVICE not supported for 'ai_socktype'.  */
 | 
						|
#  define EAI_MEMORY      -10   /* Memory allocation failure.  */
 | 
						|
# endif
 | 
						|
 | 
						|
/* Since EAI_NODATA is deprecated by RFC3493, some systems (at least
 | 
						|
   FreeBSD, which does define EAI_BADFLAGS) have removed the definition
 | 
						|
   in favor of EAI_NONAME.  */
 | 
						|
# if !defined EAI_NODATA && defined EAI_NONAME
 | 
						|
#  define EAI_NODATA EAI_NONAME
 | 
						|
# endif
 | 
						|
 | 
						|
# ifndef EAI_OVERFLOW
 | 
						|
/* Not defined on mingw32 and Haiku. */
 | 
						|
#  define EAI_OVERFLOW    -12   /* Argument buffer overflow.  */
 | 
						|
# endif
 | 
						|
# ifndef EAI_ADDRFAMILY
 | 
						|
/* Not defined on mingw32. */
 | 
						|
#  define EAI_ADDRFAMILY  -9    /* Address family for NAME not supported.  */
 | 
						|
# endif
 | 
						|
# ifndef EAI_SYSTEM
 | 
						|
/* Not defined on mingw32. */
 | 
						|
#  define EAI_SYSTEM      -11   /* System error returned in 'errno'.  */
 | 
						|
# endif
 | 
						|
 | 
						|
# if 0
 | 
						|
/* The commented out definitions below are not yet implemented in the
 | 
						|
   GNULIB getaddrinfo() replacement, so are not yet needed.
 | 
						|
 | 
						|
   If they are restored, be sure to protect the definitions with #ifndef.  */
 | 
						|
#  ifndef EAI_INPROGRESS
 | 
						|
#   define EAI_INPROGRESS       -100    /* Processing request in progress.  */
 | 
						|
#   define EAI_CANCELED         -101    /* Request canceled.  */
 | 
						|
#   define EAI_NOTCANCELED      -102    /* Request not canceled.  */
 | 
						|
#   define EAI_ALLDONE          -103    /* All requests done.  */
 | 
						|
#   define EAI_INTR             -104    /* Interrupted by a signal.  */
 | 
						|
#   define EAI_IDN_ENCODE       -105    /* IDN encoding failed.  */
 | 
						|
#  endif
 | 
						|
# endif
 | 
						|
 | 
						|
/* Translate name of a service location and/or a service name to set of
 | 
						|
   socket addresses.
 | 
						|
   For more details, see the POSIX:2008 specification
 | 
						|
   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getaddrinfo.html>.  */
 | 
						|
# if @REPLACE_GETADDRINFO@
 | 
						|
#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 | 
						|
#   undef getaddrinfo
 | 
						|
#   define getaddrinfo rpl_getaddrinfo
 | 
						|
#  endif
 | 
						|
_GL_FUNCDECL_RPL (getaddrinfo, int,
 | 
						|
                  (const char *restrict nodename,
 | 
						|
                   const char *restrict servname,
 | 
						|
                   const struct addrinfo *restrict hints,
 | 
						|
                   struct addrinfo **restrict res)
 | 
						|
                  _GL_ARG_NONNULL ((4)));
 | 
						|
_GL_CXXALIAS_RPL (getaddrinfo, int,
 | 
						|
                  (const char *restrict nodename,
 | 
						|
                   const char *restrict servname,
 | 
						|
                   const struct addrinfo *restrict hints,
 | 
						|
                   struct addrinfo **restrict res));
 | 
						|
# else
 | 
						|
#  if !@HAVE_DECL_GETADDRINFO@
 | 
						|
_GL_FUNCDECL_SYS (getaddrinfo, int,
 | 
						|
                  (const char *restrict nodename,
 | 
						|
                   const char *restrict servname,
 | 
						|
                   const struct addrinfo *restrict hints,
 | 
						|
                   struct addrinfo **restrict res)
 | 
						|
                  _GL_ARG_NONNULL ((4)));
 | 
						|
#  endif
 | 
						|
_GL_CXXALIAS_SYS (getaddrinfo, int,
 | 
						|
                  (const char *restrict nodename,
 | 
						|
                   const char *restrict servname,
 | 
						|
                   const struct addrinfo *restrict hints,
 | 
						|
                   struct addrinfo **restrict res));
 | 
						|
# endif
 | 
						|
_GL_CXXALIASWARN (getaddrinfo);
 | 
						|
 | 
						|
/* Free 'addrinfo' structure AI including associated storage.
 | 
						|
   For more details, see the POSIX:2008 specification
 | 
						|
   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getaddrinfo.html>.  */
 | 
						|
# if @REPLACE_GETADDRINFO@
 | 
						|
#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 | 
						|
#   undef freeaddrinfo
 | 
						|
#   define freeaddrinfo rpl_freeaddrinfo
 | 
						|
#  endif
 | 
						|
_GL_FUNCDECL_RPL (freeaddrinfo, void, (struct addrinfo *ai)
 | 
						|
                                      _GL_ARG_NONNULL ((1)));
 | 
						|
_GL_CXXALIAS_RPL (freeaddrinfo, void, (struct addrinfo *ai));
 | 
						|
# else
 | 
						|
#  if !@HAVE_DECL_FREEADDRINFO@
 | 
						|
_GL_FUNCDECL_SYS (freeaddrinfo, void, (struct addrinfo *ai)
 | 
						|
                                      _GL_ARG_NONNULL ((1)));
 | 
						|
#  endif
 | 
						|
_GL_CXXALIAS_SYS (freeaddrinfo, void, (struct addrinfo *ai));
 | 
						|
# endif
 | 
						|
_GL_CXXALIASWARN (freeaddrinfo);
 | 
						|
 | 
						|
# if @REPLACE_GAI_STRERROR@
 | 
						|
#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 | 
						|
#   undef gai_strerror
 | 
						|
#   define gai_strerror rpl_gai_strerror
 | 
						|
#  endif
 | 
						|
_GL_FUNCDECL_RPL (gai_strerror, const char *, (int ecode));
 | 
						|
_GL_CXXALIAS_RPL (gai_strerror, const char *, (int ecode));
 | 
						|
# else
 | 
						|
#  if !@HAVE_DECL_GAI_STRERROR@
 | 
						|
/* Convert error return from getaddrinfo() to a string.
 | 
						|
   For more details, see the POSIX:2008 specification
 | 
						|
   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/gai_strerror.html>.  */
 | 
						|
_GL_FUNCDECL_SYS (gai_strerror, const char *, (int ecode));
 | 
						|
#  endif
 | 
						|
_GL_CXXALIAS_SYS (gai_strerror, const char *, (int ecode));
 | 
						|
# endif
 | 
						|
# if __GLIBC__ >= 2
 | 
						|
_GL_CXXALIASWARN (gai_strerror);
 | 
						|
# endif
 | 
						|
 | 
						|
# if !@HAVE_DECL_GETNAMEINFO@
 | 
						|
/* Convert socket address to printable node and service names.
 | 
						|
   For more details, see the POSIX:2008 specification
 | 
						|
   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getnameinfo.html>.  */
 | 
						|
_GL_FUNCDECL_SYS (getnameinfo, int,
 | 
						|
                  (const struct sockaddr *restrict sa, socklen_t salen,
 | 
						|
                   char *restrict node, socklen_t nodelen,
 | 
						|
                   char *restrict service, socklen_t servicelen,
 | 
						|
                   int flags)
 | 
						|
                  _GL_ARG_NONNULL ((1)));
 | 
						|
# endif
 | 
						|
/* Need to cast, because on glibc systems, the seventh parameter is
 | 
						|
                        unsigned int flags.  */
 | 
						|
_GL_CXXALIAS_SYS_CAST (getnameinfo, int,
 | 
						|
                       (const struct sockaddr *restrict sa, socklen_t salen,
 | 
						|
                        char *restrict node, socklen_t nodelen,
 | 
						|
                        char *restrict service, socklen_t servicelen,
 | 
						|
                        int flags));
 | 
						|
_GL_CXXALIASWARN (getnameinfo);
 | 
						|
 | 
						|
/* Possible flags for getnameinfo.  */
 | 
						|
# ifndef NI_NUMERICHOST
 | 
						|
#  define NI_NUMERICHOST 1
 | 
						|
# endif
 | 
						|
# ifndef NI_NUMERICSERV
 | 
						|
#  define NI_NUMERICSERV 2
 | 
						|
# endif
 | 
						|
 | 
						|
#elif defined GNULIB_POSIXCHECK
 | 
						|
 | 
						|
# undef getaddrinfo
 | 
						|
# if HAVE_RAW_DECL_GETADDRINFO
 | 
						|
_GL_WARN_ON_USE (getaddrinfo, "getaddrinfo is unportable - "
 | 
						|
                 "use gnulib module getaddrinfo for portability");
 | 
						|
# endif
 | 
						|
 | 
						|
# undef freeaddrinfo
 | 
						|
# if HAVE_RAW_DECL_FREEADDRINFO
 | 
						|
_GL_WARN_ON_USE (freeaddrinfo, "freeaddrinfo is unportable - "
 | 
						|
                 "use gnulib module getaddrinfo for portability");
 | 
						|
# endif
 | 
						|
 | 
						|
# undef gai_strerror
 | 
						|
# if HAVE_RAW_DECL_GAI_STRERROR
 | 
						|
_GL_WARN_ON_USE (gai_strerror, "gai_strerror is unportable - "
 | 
						|
                 "use gnulib module getaddrinfo for portability");
 | 
						|
# endif
 | 
						|
 | 
						|
# undef getnameinfo
 | 
						|
# if HAVE_RAW_DECL_GETNAMEINFO
 | 
						|
_GL_WARN_ON_USE (getnameinfo, "getnameinfo is unportable - "
 | 
						|
                 "use gnulib module getaddrinfo for portability");
 | 
						|
# endif
 | 
						|
 | 
						|
#endif
 | 
						|
 | 
						|
#endif /* _@GUARD_PREFIX@_NETDB_H */
 | 
						|
#endif /* _@GUARD_PREFIX@_NETDB_H */
 |