mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-08-22 02:43:23 +02:00
This function has been added in OpenSSL 0.9.8, which is the oldest version supported on HEAD, so checking for it at configure time is useless. Both the frontend and backend code did not even bother to use it. Reported-by: Daniel Gustafsson Author: Michael Paquier Reviewed-by: Daniel Gustafsson, Tom Lane Discussion: https://postgr.es/m/20191205083252.GE5064@paquier.xyz Discussion: https://postgr.es/m/98F7F99E-1129-41D8-B86B-FE3B1E286881@yesql.se
534 lines
16 KiB
C
534 lines
16 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* port.h
|
|
* Header for src/port/ compatibility functions.
|
|
*
|
|
* Portions Copyright (c) 1996-2019, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/port.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef PG_PORT_H
|
|
#define PG_PORT_H
|
|
|
|
#include <ctype.h>
|
|
#include <netdb.h>
|
|
#include <pwd.h>
|
|
|
|
/*
|
|
* Windows has enough specialized port stuff that we push most of it off
|
|
* into another file.
|
|
* Note: Some CYGWIN includes might #define WIN32.
|
|
*/
|
|
#if defined(WIN32) && !defined(__CYGWIN__)
|
|
#include "port/win32_port.h"
|
|
#endif
|
|
|
|
/* socket has a different definition on WIN32 */
|
|
#ifndef WIN32
|
|
typedef int pgsocket;
|
|
|
|
#define PGINVALID_SOCKET (-1)
|
|
#else
|
|
typedef SOCKET pgsocket;
|
|
|
|
#define PGINVALID_SOCKET INVALID_SOCKET
|
|
#endif
|
|
|
|
/* non-blocking */
|
|
extern bool pg_set_noblock(pgsocket sock);
|
|
extern bool pg_set_block(pgsocket sock);
|
|
|
|
/* Portable path handling for Unix/Win32 (in path.c) */
|
|
|
|
extern bool has_drive_prefix(const char *filename);
|
|
extern char *first_dir_separator(const char *filename);
|
|
extern char *last_dir_separator(const char *filename);
|
|
extern char *first_path_var_separator(const char *pathlist);
|
|
extern void join_path_components(char *ret_path,
|
|
const char *head, const char *tail);
|
|
extern void canonicalize_path(char *path);
|
|
extern void make_native_path(char *path);
|
|
extern void cleanup_path(char *path);
|
|
extern bool path_contains_parent_reference(const char *path);
|
|
extern bool path_is_relative_and_below_cwd(const char *path);
|
|
extern bool path_is_prefix_of_path(const char *path1, const char *path2);
|
|
extern char *make_absolute_path(const char *path);
|
|
extern const char *get_progname(const char *argv0);
|
|
extern void get_share_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_etc_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_include_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_pkginclude_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_includeserver_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_lib_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_pkglib_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_locale_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_doc_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_html_path(const char *my_exec_path, char *ret_path);
|
|
extern void get_man_path(const char *my_exec_path, char *ret_path);
|
|
extern bool get_home_path(char *ret_path);
|
|
extern void get_parent_directory(char *path);
|
|
|
|
/* common/pgfnames.c */
|
|
extern char **pgfnames(const char *path);
|
|
extern void pgfnames_cleanup(char **filenames);
|
|
|
|
/*
|
|
* is_absolute_path
|
|
*
|
|
* By making this a macro we avoid needing to include path.c in libpq.
|
|
*/
|
|
#ifndef WIN32
|
|
#define IS_DIR_SEP(ch) ((ch) == '/')
|
|
|
|
#define is_absolute_path(filename) \
|
|
( \
|
|
IS_DIR_SEP((filename)[0]) \
|
|
)
|
|
#else
|
|
#define IS_DIR_SEP(ch) ((ch) == '/' || (ch) == '\\')
|
|
|
|
/* See path_is_relative_and_below_cwd() for how we handle 'E:abc'. */
|
|
#define is_absolute_path(filename) \
|
|
( \
|
|
IS_DIR_SEP((filename)[0]) || \
|
|
(isalpha((unsigned char) ((filename)[0])) && (filename)[1] == ':' && \
|
|
IS_DIR_SEP((filename)[2])) \
|
|
)
|
|
#endif
|
|
|
|
/* Portable locale initialization (in exec.c) */
|
|
extern void set_pglocale_pgservice(const char *argv0, const char *app);
|
|
|
|
/* Portable way to find binaries (in exec.c) */
|
|
extern int find_my_exec(const char *argv0, char *retpath);
|
|
extern int find_other_exec(const char *argv0, const char *target,
|
|
const char *versionstr, char *retpath);
|
|
|
|
/* Doesn't belong here, but this is used with find_other_exec(), so... */
|
|
#define PG_BACKEND_VERSIONSTR "postgres (PostgreSQL) " PG_VERSION "\n"
|
|
|
|
|
|
#if defined(WIN32) || defined(__CYGWIN__)
|
|
#define EXE ".exe"
|
|
#else
|
|
#define EXE ""
|
|
#endif
|
|
|
|
#if defined(WIN32) && !defined(__CYGWIN__)
|
|
#define DEVNULL "nul"
|
|
#else
|
|
#define DEVNULL "/dev/null"
|
|
#endif
|
|
|
|
/* Portable delay handling */
|
|
extern void pg_usleep(long microsec);
|
|
|
|
/* Portable SQL-like case-independent comparisons and conversions */
|
|
extern int pg_strcasecmp(const char *s1, const char *s2);
|
|
extern int pg_strncasecmp(const char *s1, const char *s2, size_t n);
|
|
extern unsigned char pg_toupper(unsigned char ch);
|
|
extern unsigned char pg_tolower(unsigned char ch);
|
|
extern unsigned char pg_ascii_toupper(unsigned char ch);
|
|
extern unsigned char pg_ascii_tolower(unsigned char ch);
|
|
|
|
/*
|
|
* Beginning in v12, we always replace snprintf() and friends with our own
|
|
* implementation. This symbol is no longer consulted by the core code,
|
|
* but keep it defined anyway in case any extensions are looking at it.
|
|
*/
|
|
#define USE_REPL_SNPRINTF 1
|
|
|
|
/*
|
|
* Versions of libintl >= 0.13 try to replace printf() and friends with
|
|
* macros to their own versions that understand the %$ format. We do the
|
|
* same, so disable their macros, if they exist.
|
|
*/
|
|
#ifdef vsnprintf
|
|
#undef vsnprintf
|
|
#endif
|
|
#ifdef snprintf
|
|
#undef snprintf
|
|
#endif
|
|
#ifdef vsprintf
|
|
#undef vsprintf
|
|
#endif
|
|
#ifdef sprintf
|
|
#undef sprintf
|
|
#endif
|
|
#ifdef vfprintf
|
|
#undef vfprintf
|
|
#endif
|
|
#ifdef fprintf
|
|
#undef fprintf
|
|
#endif
|
|
#ifdef vprintf
|
|
#undef vprintf
|
|
#endif
|
|
#ifdef printf
|
|
#undef printf
|
|
#endif
|
|
|
|
extern int pg_vsnprintf(char *str, size_t count, const char *fmt, va_list args);
|
|
extern int pg_snprintf(char *str, size_t count, const char *fmt,...) pg_attribute_printf(3, 4);
|
|
extern int pg_vsprintf(char *str, const char *fmt, va_list args);
|
|
extern int pg_sprintf(char *str, const char *fmt,...) pg_attribute_printf(2, 3);
|
|
extern int pg_vfprintf(FILE *stream, const char *fmt, va_list args);
|
|
extern int pg_fprintf(FILE *stream, const char *fmt,...) pg_attribute_printf(2, 3);
|
|
extern int pg_vprintf(const char *fmt, va_list args);
|
|
extern int pg_printf(const char *fmt,...) pg_attribute_printf(1, 2);
|
|
|
|
/*
|
|
* We use __VA_ARGS__ for printf to prevent replacing references to
|
|
* the "printf" format archetype in format() attribute declarations.
|
|
* That unfortunately means that taking a function pointer to printf
|
|
* will not do what we'd wish. (If you need to do that, you must name
|
|
* pg_printf explicitly.) For printf's sibling functions, use
|
|
* parameterless macros so that function pointers will work unsurprisingly.
|
|
*/
|
|
#define vsnprintf pg_vsnprintf
|
|
#define snprintf pg_snprintf
|
|
#define vsprintf pg_vsprintf
|
|
#define sprintf pg_sprintf
|
|
#define vfprintf pg_vfprintf
|
|
#define fprintf pg_fprintf
|
|
#define vprintf pg_vprintf
|
|
#define printf(...) pg_printf(__VA_ARGS__)
|
|
|
|
/* This is also provided by snprintf.c */
|
|
extern int pg_strfromd(char *str, size_t count, int precision, double value);
|
|
|
|
/* Replace strerror() with our own, somewhat more robust wrapper */
|
|
extern char *pg_strerror(int errnum);
|
|
#define strerror pg_strerror
|
|
|
|
/* Likewise for strerror_r(); note we prefer the GNU API for that */
|
|
extern char *pg_strerror_r(int errnum, char *buf, size_t buflen);
|
|
#define strerror_r pg_strerror_r
|
|
#define PG_STRERROR_R_BUFLEN 256 /* Recommended buffer size for strerror_r */
|
|
|
|
/* Wrap strsignal(), or provide our own version if necessary */
|
|
extern const char *pg_strsignal(int signum);
|
|
|
|
/* Portable prompt handling */
|
|
extern void simple_prompt(const char *prompt, char *destination, size_t destlen,
|
|
bool echo);
|
|
|
|
extern int pclose_check(FILE *stream);
|
|
|
|
/* Global variable holding time zone information. */
|
|
#if defined(WIN32) || defined(__CYGWIN__)
|
|
#define TIMEZONE_GLOBAL _timezone
|
|
#define TZNAME_GLOBAL _tzname
|
|
#else
|
|
#define TIMEZONE_GLOBAL timezone
|
|
#define TZNAME_GLOBAL tzname
|
|
#endif
|
|
|
|
#if defined(WIN32) || defined(__CYGWIN__)
|
|
/*
|
|
* Win32 doesn't have reliable rename/unlink during concurrent access.
|
|
*/
|
|
extern int pgrename(const char *from, const char *to);
|
|
extern int pgunlink(const char *path);
|
|
|
|
/* Include this first so later includes don't see these defines */
|
|
#ifdef _MSC_VER
|
|
#include <io.h>
|
|
#endif
|
|
|
|
#define rename(from, to) pgrename(from, to)
|
|
#define unlink(path) pgunlink(path)
|
|
#endif /* defined(WIN32) || defined(__CYGWIN__) */
|
|
|
|
/*
|
|
* Win32 also doesn't have symlinks, but we can emulate them with
|
|
* junction points on newer Win32 versions.
|
|
*
|
|
* Cygwin has its own symlinks which work on Win95/98/ME where
|
|
* junction points don't, so use those instead. We have no way of
|
|
* knowing what type of system Cygwin binaries will be run on.
|
|
* Note: Some CYGWIN includes might #define WIN32.
|
|
*/
|
|
#if defined(WIN32) && !defined(__CYGWIN__)
|
|
extern int pgsymlink(const char *oldpath, const char *newpath);
|
|
extern int pgreadlink(const char *path, char *buf, size_t size);
|
|
extern bool pgwin32_is_junction(const char *path);
|
|
|
|
#define symlink(oldpath, newpath) pgsymlink(oldpath, newpath)
|
|
#define readlink(path, buf, size) pgreadlink(path, buf, size)
|
|
#endif
|
|
|
|
extern bool rmtree(const char *path, bool rmtopdir);
|
|
|
|
#if defined(WIN32) && !defined(__CYGWIN__)
|
|
|
|
/*
|
|
* open() and fopen() replacements to allow deletion of open files and
|
|
* passing of other special options.
|
|
*/
|
|
#define O_DIRECT 0x80000000
|
|
extern int pgwin32_open(const char *, int,...);
|
|
extern FILE *pgwin32_fopen(const char *, const char *);
|
|
#define open(a,b,c) pgwin32_open(a,b,c)
|
|
#define fopen(a,b) pgwin32_fopen(a,b)
|
|
|
|
/*
|
|
* Mingw-w64 headers #define popen and pclose to _popen and _pclose. We want
|
|
* to use our popen wrapper, rather than plain _popen, so override that. For
|
|
* consistency, use our version of pclose, too.
|
|
*/
|
|
#ifdef popen
|
|
#undef popen
|
|
#endif
|
|
#ifdef pclose
|
|
#undef pclose
|
|
#endif
|
|
|
|
/*
|
|
* system() and popen() replacements to enclose the command in an extra
|
|
* pair of quotes.
|
|
*/
|
|
extern int pgwin32_system(const char *command);
|
|
extern FILE *pgwin32_popen(const char *command, const char *type);
|
|
|
|
#define system(a) pgwin32_system(a)
|
|
#define popen(a,b) pgwin32_popen(a,b)
|
|
#define pclose(a) _pclose(a)
|
|
|
|
/* New versions of MingW have gettimeofday, old mingw and msvc don't */
|
|
#ifndef HAVE_GETTIMEOFDAY
|
|
/* Last parameter not used */
|
|
extern int gettimeofday(struct timeval *tp, struct timezone *tzp);
|
|
#endif
|
|
#else /* !WIN32 */
|
|
|
|
/*
|
|
* Win32 requires a special close for sockets and pipes, while on Unix
|
|
* close() does them all.
|
|
*/
|
|
#define closesocket close
|
|
#endif /* WIN32 */
|
|
|
|
/*
|
|
* On Windows, setvbuf() does not support _IOLBF mode, and interprets that
|
|
* as _IOFBF. To add insult to injury, setvbuf(file, NULL, _IOFBF, 0)
|
|
* crashes outright if "parameter validation" is enabled. Therefore, in
|
|
* places where we'd like to select line-buffered mode, we fall back to
|
|
* unbuffered mode instead on Windows. Always use PG_IOLBF not _IOLBF
|
|
* directly in order to implement this behavior.
|
|
*/
|
|
#ifndef WIN32
|
|
#define PG_IOLBF _IOLBF
|
|
#else
|
|
#define PG_IOLBF _IONBF
|
|
#endif
|
|
|
|
/*
|
|
* Default "extern" declarations or macro substitutes for library routines.
|
|
* When necessary, these routines are provided by files in src/port/.
|
|
*/
|
|
|
|
/* WIN32 handled in port/win32_port.h */
|
|
#ifndef WIN32
|
|
#define pgoff_t off_t
|
|
#ifdef __NetBSD__
|
|
extern int fseeko(FILE *stream, off_t offset, int whence);
|
|
extern off_t ftello(FILE *stream);
|
|
#endif
|
|
#endif
|
|
|
|
extern double pg_erand48(unsigned short xseed[3]);
|
|
extern long pg_lrand48(void);
|
|
extern long pg_jrand48(unsigned short xseed[3]);
|
|
extern void pg_srand48(long seed);
|
|
|
|
#ifndef HAVE_FLS
|
|
extern int fls(int mask);
|
|
#endif
|
|
|
|
#ifndef HAVE_FSEEKO
|
|
#define fseeko(a, b, c) fseek(a, b, c)
|
|
#define ftello(a) ftell(a)
|
|
#endif
|
|
|
|
#if !defined(HAVE_GETPEEREID) && !defined(WIN32)
|
|
extern int getpeereid(int sock, uid_t *uid, gid_t *gid);
|
|
#endif
|
|
|
|
#ifndef HAVE_ISINF
|
|
extern int isinf(double x);
|
|
#else
|
|
/*
|
|
* Glibc doesn't use the builtin for clang due to a *gcc* bug in a version
|
|
* newer than the gcc compatibility clang claims to have. This would cause a
|
|
* *lot* of superfluous function calls, therefore revert when using clang. In
|
|
* C++ there's issues with libc++ (not libstdc++), so disable as well.
|
|
*/
|
|
#if defined(__clang__) && !defined(__cplusplus)
|
|
/* needs to be separate to not confuse other compilers */
|
|
#if __has_builtin(__builtin_isinf)
|
|
/* need to include before, to avoid getting overwritten */
|
|
#include <math.h>
|
|
#undef isinf
|
|
#define isinf __builtin_isinf
|
|
#endif /* __has_builtin(isinf) */
|
|
#endif /* __clang__ && !__cplusplus */
|
|
#endif /* !HAVE_ISINF */
|
|
|
|
#ifndef HAVE_EXPLICIT_BZERO
|
|
extern void explicit_bzero(void *buf, size_t len);
|
|
#endif
|
|
|
|
#ifndef HAVE_STRTOF
|
|
extern float strtof(const char *nptr, char **endptr);
|
|
#endif
|
|
|
|
#ifdef HAVE_BUGGY_STRTOF
|
|
extern float pg_strtof(const char *nptr, char **endptr);
|
|
#define strtof(a,b) (pg_strtof((a),(b)))
|
|
#endif
|
|
|
|
#ifndef HAVE_MKDTEMP
|
|
extern char *mkdtemp(char *path);
|
|
#endif
|
|
|
|
#ifndef HAVE_RINT
|
|
extern double rint(double x);
|
|
#endif
|
|
|
|
#ifndef HAVE_INET_ATON
|
|
#include <netinet/in.h>
|
|
#include <arpa/inet.h>
|
|
extern int inet_aton(const char *cp, struct in_addr *addr);
|
|
#endif
|
|
|
|
/*
|
|
* Windows and older Unix don't have pread(2) and pwrite(2). We have
|
|
* replacement functions, but they have slightly different semantics so we'll
|
|
* use a name with a pg_ prefix to avoid confusion.
|
|
*/
|
|
#ifdef HAVE_PREAD
|
|
#define pg_pread pread
|
|
#else
|
|
extern ssize_t pg_pread(int fd, void *buf, size_t nbyte, off_t offset);
|
|
#endif
|
|
|
|
#ifdef HAVE_PWRITE
|
|
#define pg_pwrite pwrite
|
|
#else
|
|
extern ssize_t pg_pwrite(int fd, const void *buf, size_t nbyte, off_t offset);
|
|
#endif
|
|
|
|
#if !HAVE_DECL_STRLCAT
|
|
extern size_t strlcat(char *dst, const char *src, size_t siz);
|
|
#endif
|
|
|
|
#if !HAVE_DECL_STRLCPY
|
|
extern size_t strlcpy(char *dst, const char *src, size_t siz);
|
|
#endif
|
|
|
|
#if !HAVE_DECL_STRNLEN
|
|
extern size_t strnlen(const char *str, size_t maxlen);
|
|
#endif
|
|
|
|
#if !defined(HAVE_RANDOM)
|
|
extern long random(void);
|
|
#endif
|
|
|
|
#ifndef HAVE_UNSETENV
|
|
extern void unsetenv(const char *name);
|
|
#endif
|
|
|
|
#ifndef HAVE_SRANDOM
|
|
extern void srandom(unsigned int seed);
|
|
#endif
|
|
|
|
#ifndef HAVE_DLOPEN
|
|
extern void *dlopen(const char *file, int mode);
|
|
extern void *dlsym(void *handle, const char *symbol);
|
|
extern int dlclose(void *handle);
|
|
extern char *dlerror(void);
|
|
#endif
|
|
|
|
/*
|
|
* In some older systems, the RTLD_NOW flag isn't defined and the mode
|
|
* argument to dlopen must always be 1.
|
|
*/
|
|
#if !HAVE_DECL_RTLD_NOW
|
|
#define RTLD_NOW 1
|
|
#endif
|
|
|
|
/*
|
|
* The RTLD_GLOBAL flag is wanted if available, but it doesn't exist
|
|
* everywhere. If it doesn't exist, set it to 0 so it has no effect.
|
|
*/
|
|
#if !HAVE_DECL_RTLD_GLOBAL
|
|
#define RTLD_GLOBAL 0
|
|
#endif
|
|
|
|
/* thread.h */
|
|
#ifndef WIN32
|
|
extern int pqGetpwuid(uid_t uid, struct passwd *resultbuf, char *buffer,
|
|
size_t buflen, struct passwd **result);
|
|
#endif
|
|
|
|
extern int pqGethostbyname(const char *name,
|
|
struct hostent *resultbuf,
|
|
char *buffer, size_t buflen,
|
|
struct hostent **result,
|
|
int *herrno);
|
|
|
|
extern void pg_qsort(void *base, size_t nel, size_t elsize,
|
|
int (*cmp) (const void *, const void *));
|
|
extern int pg_qsort_strcmp(const void *a, const void *b);
|
|
|
|
#define qsort(a,b,c,d) pg_qsort(a,b,c,d)
|
|
|
|
typedef int (*qsort_arg_comparator) (const void *a, const void *b, void *arg);
|
|
|
|
extern void qsort_arg(void *base, size_t nel, size_t elsize,
|
|
qsort_arg_comparator cmp, void *arg);
|
|
|
|
/* port/chklocale.c */
|
|
extern int pg_get_encoding_from_locale(const char *ctype, bool write_message);
|
|
|
|
#if defined(WIN32) && !defined(FRONTEND)
|
|
extern int pg_codepage_to_encoding(UINT cp);
|
|
#endif
|
|
|
|
/* port/inet_net_ntop.c */
|
|
extern char *pg_inet_net_ntop(int af, const void *src, int bits,
|
|
char *dst, size_t size);
|
|
|
|
/* port/pg_strong_random.c */
|
|
extern bool pg_strong_random(void *buf, size_t len);
|
|
|
|
/*
|
|
* pg_backend_random used to be a wrapper for pg_strong_random before
|
|
* Postgres 12 for the backend code.
|
|
*/
|
|
#define pg_backend_random pg_strong_random
|
|
|
|
/* port/pgcheckdir.c */
|
|
extern int pg_check_dir(const char *dir);
|
|
|
|
/* port/pgmkdirp.c */
|
|
extern int pg_mkdir_p(char *path, int omode);
|
|
|
|
/* port/pqsignal.c */
|
|
typedef void (*pqsigfunc) (int signo);
|
|
extern pqsigfunc pqsignal(int signo, pqsigfunc func);
|
|
|
|
/* port/quotes.c */
|
|
extern char *escape_single_quotes_ascii(const char *src);
|
|
|
|
/* common/wait_error.c */
|
|
extern char *wait_result_to_str(int exit_status);
|
|
extern bool wait_result_is_signal(int exit_status, int signum);
|
|
extern bool wait_result_is_any_signal(int exit_status, bool include_command_not_found);
|
|
|
|
#endif /* PG_PORT_H */
|