| #ifndef HEADER_CURL_SETUP_H |
| #define HEADER_CURL_SETUP_H |
| /*************************************************************************** |
| * _ _ ____ _ |
| * Project ___| | | | _ \| | |
| * / __| | | | |_) | | |
| * | (__| |_| | _ <| |___ |
| * \___|\___/|_| \_\_____| |
| * |
| * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. |
| * |
| * This software is licensed as described in the file COPYING, which |
| * you should have received as part of this distribution. The terms |
| * are also available at https://curl.se/docs/copyright.html. |
| * |
| * You may opt to use, copy, modify, merge, publish, distribute and/or sell |
| * copies of the Software, and permit persons to whom the Software is |
| * furnished to do so, under the terms of the COPYING file. |
| * |
| * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY |
| * KIND, either express or implied. |
| * |
| * SPDX-License-Identifier: curl |
| * |
| ***************************************************************************/ |
| |
| #if defined(BUILDING_LIBCURL) && !defined(CURL_NO_OLDIES) |
| #define CURL_NO_OLDIES |
| #endif |
| |
| /* Set default _WIN32_WINNT */ |
| #ifdef __MINGW32__ |
| #include <_mingw.h> |
| #endif |
| |
| /* Workaround for Homebrew gcc 12.4.0, 13.3.0, 14.1.0, 14.2.0 (initial build) |
| that started advertising the `availability` attribute, which then gets used |
| by Apple SDK, but, in a way incompatible with gcc, resulting in misc errors |
| inside SDK headers, e.g.: |
| error: attributes should be specified before the declarator in a function |
| definition |
| error: expected ',' or '}' before |
| Followed by missing declarations. |
| Work it around by overriding the built-in feature-check macro used by the |
| headers to enable the problematic attributes. This makes the feature check |
| fail. Fixed in 14.2.0_1. Disable the workaround if the fix is detected. */ |
| #if defined(__APPLE__) && !defined(__clang__) && defined(__GNUC__) && \ |
| defined(__has_attribute) |
| # if !defined(__has_feature) /* Keep this PP check separate from others */ |
| # define availability curl_pp_attribute_disabled |
| # elif !__has_feature(attribute_availability) |
| # define availability curl_pp_attribute_disabled |
| # endif |
| #endif |
| |
| #ifdef __APPLE__ |
| #include <sys/types.h> |
| #include <TargetConditionals.h> |
| /* Fixup faulty target macro initialization in macOS SDK since v14.4 (as of |
| 15.0 beta). The SDK target detection in `TargetConditionals.h` correctly |
| detects macOS, but fails to set the macro's old name `TARGET_OS_OSX`, then |
| continues to set it to a default value of 0. Other parts of the SDK still |
| rely on the old name, and with this inconsistency our builds fail due to |
| missing declarations. It happens when using mainline llvm older than v18. |
| Later versions fixed it by predefining these target macros, avoiding the |
| faulty dynamic detection. gcc is not affected (for now) because it lacks |
| the necessary dynamic detection features, so the SDK falls back to |
| a codepath that sets both the old and new macro to 1. */ |
| #if defined(TARGET_OS_MAC) && TARGET_OS_MAC && \ |
| defined(TARGET_OS_OSX) && !TARGET_OS_OSX && \ |
| (!defined(TARGET_OS_IPHONE) || !TARGET_OS_IPHONE) && \ |
| (!defined(TARGET_OS_SIMULATOR) || !TARGET_OS_SIMULATOR) |
| #undef TARGET_OS_OSX |
| #define TARGET_OS_OSX TARGET_OS_MAC |
| #endif |
| #endif |
| |
| #if defined(__MINGW32__) && \ |
| (!defined(__MINGW64_VERSION_MAJOR) || (__MINGW64_VERSION_MAJOR < 3)) |
| #error "Building curl requires mingw-w64 3.0 or later" |
| #endif |
| |
| /* Visual Studio 2010 is the minimum Visual Studio version we support. |
| Workarounds for older versions of Visual Studio have been removed. */ |
| #if defined(_MSC_VER) && (_MSC_VER < 1600) |
| #error "Ancient versions of Visual Studio are no longer supported due to bugs." |
| #endif |
| |
| #ifdef _MSC_VER |
| /* Disable Visual Studio warnings: 4127 "conditional expression is constant" */ |
| #pragma warning(disable:4127) |
| #ifndef _CRT_SECURE_NO_WARNINGS |
| #define _CRT_SECURE_NO_WARNINGS /* for getenv(), sscanf() */ |
| #endif |
| #endif /* _MSC_VER */ |
| |
| #ifdef _WIN32 |
| /* |
| * Do not include unneeded stuff in Windows headers to avoid compiler |
| * warnings and macro clashes. |
| * Make sure to define this macro before including any Windows headers. |
| */ |
| # ifndef WIN32_LEAN_AND_MEAN |
| # define WIN32_LEAN_AND_MEAN |
| # endif |
| # ifndef NOGDI |
| # define NOGDI |
| # endif |
| |
| /* Detect Windows App environment which has a restricted access |
| * to the Win32 APIs. */ |
| # if (defined(_WIN32_WINNT) && (_WIN32_WINNT >= 0x0602)) || \ |
| defined(WINAPI_FAMILY) |
| # include <winapifamily.h> |
| # if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP) && \ |
| !WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) |
| # define CURL_WINDOWS_UWP |
| # endif |
| # endif |
| |
| /* Mandatory to define SECURITY_WIN32 or SECURITY_KERNEL to indicating who is |
| compiling the code. */ |
| #undef SECURITY_KERNEL |
| #undef SECURITY_WIN32 |
| #define SECURITY_WIN32 /* for <sspi.h> */ |
| #endif |
| |
| /* Compatibility */ |
| #ifdef ENABLE_IPV6 |
| #define USE_IPV6 1 |
| #endif |
| |
| /* |
| * Include configuration script results or hand-crafted |
| * configuration file for platforms which lack config tool. |
| */ |
| |
| #ifdef HAVE_CONFIG_H |
| |
| #include "curl_config.h" |
| |
| #else /* HAVE_CONFIG_H */ |
| |
| #ifdef _WIN32 |
| # include "config-win32.h" |
| #endif |
| |
| #ifdef macintosh |
| # include "config-mac.h" |
| #endif |
| |
| #ifdef __riscos__ |
| # include "config-riscos.h" |
| #endif |
| |
| #ifdef __OS400__ |
| # include "config-os400.h" |
| #endif |
| |
| #endif /* HAVE_CONFIG_H */ |
| |
| #if defined(_MSC_VER) |
| # pragma warning(push,1) |
| #endif |
| |
| #ifdef _WIN32 |
| # if defined(_WIN32_WINNT) && (_WIN32_WINNT < 0x0600) |
| # error The minimum build target is Windows Vista (0x0600) |
| # endif |
| |
| # if !defined(CURL_WINDOWS_UWP) && (defined(_MSC_VER) || defined(__MINGW32__)) |
| # ifndef HAVE_IF_NAMETOINDEX |
| # define HAVE_IF_NAMETOINDEX |
| # endif |
| # endif |
| #endif |
| |
| /* ================================================================ */ |
| /* Definition of preprocessor macros/symbols which modify compiler */ |
| /* behavior or generated code characteristics must be done here, */ |
| /* as appropriate, before any system header file is included. It is */ |
| /* also possible to have them defined in the config file included */ |
| /* before this point. As a result of all this we frown inclusion of */ |
| /* system header files in our config files, avoid this at any cost. */ |
| /* ================================================================ */ |
| |
| #ifdef HAVE_LIBZ |
| # ifndef ZLIB_CONST |
| # define ZLIB_CONST /* Use z_const. Supported by v1.2.5.2 and upper. */ |
| # endif |
| #endif |
| |
| /* |
| * AIX 4.3 and newer needs _THREAD_SAFE defined to build |
| * proper reentrant code. Others may also need it. |
| */ |
| #ifdef NEED_THREAD_SAFE |
| # ifndef _THREAD_SAFE |
| # define _THREAD_SAFE |
| # endif |
| #endif |
| |
| /* |
| * Tru64 needs _REENTRANT set for a few function prototypes and |
| * things to appear in the system header files. Unixware needs it |
| * to build proper reentrant code. Others may also need it. |
| */ |
| #ifdef NEED_REENTRANT |
| # ifndef _REENTRANT |
| # define _REENTRANT |
| # endif |
| #endif |
| |
| /* Solaris needs this to get a POSIX-conformant getpwuid_r */ |
| #if defined(sun) || defined(__sun) |
| # ifndef _POSIX_PTHREAD_SEMANTICS |
| # define _POSIX_PTHREAD_SEMANTICS 1 |
| # endif |
| #endif |
| |
| /* ================================================================ */ |
| /* If you need to include a system header file for your platform, */ |
| /* please, do it beyond the point further indicated in this file. */ |
| /* ================================================================ */ |
| |
| /* Give calloc a chance to be dragging in early, so we do not redefine */ |
| #ifdef HAVE_THREADS_POSIX |
| # include <pthread.h> |
| #endif |
| |
| /* |
| * Disable other protocols when http is the only one desired. |
| */ |
| #ifdef HTTP_ONLY |
| # ifndef CURL_DISABLE_DICT |
| # define CURL_DISABLE_DICT |
| # endif |
| # ifndef CURL_DISABLE_FILE |
| # define CURL_DISABLE_FILE |
| # endif |
| # ifndef CURL_DISABLE_FTP |
| # define CURL_DISABLE_FTP |
| # endif |
| # ifndef CURL_DISABLE_GOPHER |
| # define CURL_DISABLE_GOPHER |
| # endif |
| # ifndef CURL_DISABLE_IMAP |
| # define CURL_DISABLE_IMAP |
| # endif |
| # ifndef CURL_DISABLE_LDAP |
| # define CURL_DISABLE_LDAP |
| # endif |
| # ifndef CURL_DISABLE_LDAPS |
| # define CURL_DISABLE_LDAPS |
| # endif |
| # ifndef CURL_DISABLE_MQTT |
| # define CURL_DISABLE_MQTT |
| # endif |
| # ifndef CURL_DISABLE_POP3 |
| # define CURL_DISABLE_POP3 |
| # endif |
| # ifndef CURL_DISABLE_RTSP |
| # define CURL_DISABLE_RTSP |
| # endif |
| # ifndef CURL_DISABLE_SMTP |
| # define CURL_DISABLE_SMTP |
| # endif |
| # ifndef CURL_DISABLE_TELNET |
| # define CURL_DISABLE_TELNET |
| # endif |
| # ifndef CURL_DISABLE_TFTP |
| # define CURL_DISABLE_TFTP |
| # endif |
| # ifndef CURL_DISABLE_WEBSOCKETS |
| # define CURL_DISABLE_WEBSOCKETS |
| # endif |
| #endif |
| |
| /* |
| * When http is disabled rtsp is not supported. |
| */ |
| #if defined(CURL_DISABLE_HTTP) && !defined(CURL_DISABLE_RTSP) |
| # define CURL_DISABLE_RTSP |
| #endif |
| |
| /* |
| * When HTTP is disabled, disable HTTP-only features |
| */ |
| #ifdef CURL_DISABLE_HTTP |
| # ifndef CURL_DISABLE_ALTSVC |
| # define CURL_DISABLE_ALTSVC |
| # endif |
| # ifndef CURL_DISABLE_COOKIES |
| # define CURL_DISABLE_COOKIES |
| # endif |
| # ifndef CURL_DISABLE_BASIC_AUTH |
| # define CURL_DISABLE_BASIC_AUTH |
| # endif |
| # ifndef CURL_DISABLE_BEARER_AUTH |
| # define CURL_DISABLE_BEARER_AUTH |
| # endif |
| # ifndef CURL_DISABLE_AWS |
| # define CURL_DISABLE_AWS |
| # endif |
| # ifndef CURL_DISABLE_DOH |
| # define CURL_DISABLE_DOH |
| # endif |
| # ifndef CURL_DISABLE_FORM_API |
| # define CURL_DISABLE_FORM_API |
| # endif |
| # ifndef CURL_DISABLE_HEADERS_API |
| # define CURL_DISABLE_HEADERS_API |
| # endif |
| # ifndef CURL_DISABLE_HSTS |
| # define CURL_DISABLE_HSTS |
| # endif |
| # ifndef CURL_DISABLE_HTTP_AUTH |
| # define CURL_DISABLE_HTTP_AUTH |
| # endif |
| # ifndef CURL_DISABLE_WEBSOCKETS |
| # define CURL_DISABLE_WEBSOCKETS /* no WebSockets without HTTP present */ |
| # endif |
| #endif |
| |
| /* ================================================================ */ |
| /* No system header file shall be included in this file before this */ |
| /* point. */ |
| /* ================================================================ */ |
| |
| /* |
| * OS/400 setup file includes some system headers. |
| */ |
| #ifdef __OS400__ |
| # include "setup-os400.h" |
| #endif |
| |
| /* |
| * VMS setup file includes some system headers. |
| */ |
| #ifdef __VMS |
| # include "setup-vms.h" |
| #endif |
| |
| /* |
| * Windows setup file includes some system headers. |
| */ |
| #ifdef _WIN32 |
| # include "setup-win32.h" |
| #endif |
| |
| #include <curl/system.h> |
| |
| /* Helper macro to expand and concatenate two macros. |
| * Direct macros concatenation does not work because macros |
| * are not expanded before direct concatenation. |
| */ |
| #define CURL_CONC_MACROS_(A, B) A ## B |
| #define CURL_CONC_MACROS(A, B) CURL_CONC_MACROS_(A, B) |
| |
| /* curl uses its own printf() function internally. It understands the GNU |
| * format. Use this format, so that it matches the GNU format attribute we |
| * use with the MinGW compiler, allowing it to verify them at compile-time. |
| */ |
| #ifdef __MINGW32__ |
| # undef CURL_FORMAT_CURL_OFF_T |
| # undef CURL_FORMAT_CURL_OFF_TU |
| # define CURL_FORMAT_CURL_OFF_T "lld" |
| # define CURL_FORMAT_CURL_OFF_TU "llu" |
| #endif |
| |
| /* based on logic in "curl/mprintf.h" */ |
| #if (defined(__GNUC__) || defined(__clang__) || \ |
| defined(__IAR_SYSTEMS_ICC__)) && \ |
| defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) && \ |
| !defined(CURL_NO_FMT_CHECKS) |
| #if defined(__MINGW32__) && !defined(__clang__) |
| #define CURL_PRINTF(fmt, arg) __attribute__((format(gnu_printf, fmt, arg))) |
| #else |
| #define CURL_PRINTF(fmt, arg) __attribute__((format(__printf__, fmt, arg))) |
| #endif |
| #else |
| #define CURL_PRINTF(fmt, arg) |
| #endif |
| |
| /* Override default printf mask check rules in "curl/mprintf.h" */ |
| #define CURL_TEMP_PRINTF CURL_PRINTF |
| |
| /* Workaround for mainline llvm v16 and earlier missing a built-in macro |
| expected by macOS SDK v14 / Xcode v15 (2023) and newer. |
| gcc (as of v14) is also missing it. */ |
| #if defined(__APPLE__) && \ |
| ((!defined(__apple_build_version__) && \ |
| defined(__clang__) && __clang_major__ < 17) || \ |
| (defined(__GNUC__) && __GNUC__ <= 14)) && \ |
| defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && \ |
| !defined(__ENVIRONMENT_OS_VERSION_MIN_REQUIRED__) |
| #define __ENVIRONMENT_OS_VERSION_MIN_REQUIRED__ \ |
| __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ |
| #endif |
| |
| /* |
| * Use getaddrinfo to resolve the IPv4 address literal. If the current network |
| * interface does not support IPv4, but supports IPv6, NAT64, and DNS64, |
| * performing this task will result in a synthesized IPv6 address. |
| */ |
| #if defined(__APPLE__) && !defined(USE_ARES) |
| # define USE_RESOLVE_ON_IPS 1 |
| # if TARGET_OS_MAC && !(defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE) && \ |
| defined(USE_IPV6) |
| # define CURL_MACOS_CALL_COPYPROXIES 1 |
| # endif |
| #endif |
| |
| #ifdef USE_ARES |
| # ifndef CARES_NO_DEPRECATED |
| # define CARES_NO_DEPRECATED /* for ares_getsock() */ |
| # endif |
| # if defined(CURL_STATICLIB) && !defined(CARES_STATICLIB) && defined(_WIN32) |
| # define CARES_STATICLIB /* define it before including ares.h */ |
| # endif |
| #endif |
| |
| #ifdef USE_LWIPSOCK |
| # include <lwip/init.h> |
| # include <lwip/sockets.h> |
| # include <lwip/netdb.h> |
| #endif |
| |
| #ifdef macintosh |
| # include <extra/stricmp.h> |
| # include <extra/strdup.h> |
| #endif |
| |
| #ifdef __AMIGA__ |
| # ifdef __amigaos4__ |
| # define __USE_INLINE__ |
| /* use our own resolver which uses runtime feature detection */ |
| # define CURLRES_AMIGA |
| /* getaddrinfo() currently crashes bsdsocket.library, so disable */ |
| # undef HAVE_GETADDRINFO |
| # if !(defined(__NEWLIB__) || \ |
| (defined(__CLIB2__) && defined(__THREAD_SAFE))) |
| /* disable threaded resolver with clib2 - requires newlib or clib-ts */ |
| # undef USE_RESOLV_THREADED |
| # endif |
| # endif |
| # include <exec/types.h> |
| # include <exec/execbase.h> |
| # include <proto/exec.h> |
| # include <proto/dos.h> |
| # include <unistd.h> |
| # if defined(HAVE_PROTO_BSDSOCKET_H) && \ |
| (!defined(__amigaos4__) || defined(USE_AMISSL)) |
| /* use bsdsocket.library directly, instead of libc networking functions */ |
| # define _SYS_MBUF_H /* m_len define clashes with curl */ |
| # include <proto/bsdsocket.h> |
| # ifdef __amigaos4__ |
| int Curl_amiga_select(int nfds, fd_set *readfds, fd_set *writefds, |
| fd_set *errorfds, struct timeval *timeout); |
| # define select(a, b, c, d, e) Curl_amiga_select(a, b, c, d, e) |
| # else |
| # define select(a, b, c, d, e) WaitSelect(a, b, c, d, e, 0) |
| # endif |
| /* must not use libc's fcntl() on bsdsocket.library sockfds! */ |
| # undef HAVE_FCNTL |
| # undef HAVE_FCNTL_O_NONBLOCK |
| # else |
| /* use libc networking and hence close() and fnctl() */ |
| # undef HAVE_CLOSESOCKET_CAMEL |
| # undef HAVE_IOCTLSOCKET_CAMEL |
| # endif |
| /* |
| * In clib2 arpa/inet.h warns that some prototypes may clash |
| * with bsdsocket.library. This avoids the definition of those. |
| */ |
| # define __NO_NET_API |
| #endif |
| |
| /* Whether to use eventfd() */ |
| #if defined(HAVE_EVENTFD) && defined(HAVE_SYS_EVENTFD_H) |
| #define USE_EVENTFD |
| #endif |
| |
| #ifdef SO_NOSIGPIPE |
| #define USE_SO_NOSIGPIPE |
| #endif |
| |
| #include <stdio.h> |
| #include <assert.h> |
| |
| #ifdef __TANDEM /* for ns*-tandem-nsk systems */ |
| # ifndef __LP64 |
| # include <floss.h> /* FLOSS is only used for 32-bit builds. */ |
| # endif |
| #endif |
| |
| #ifndef STDC_HEADERS /* no standard C headers! */ |
| #include <curl/stdcheaders.h> |
| #endif |
| |
| #include <stdint.h> |
| #define HAVE_UINTPTR_T /* assume uintptr_t is provided by stdint.h */ |
| |
| #ifdef __DJGPP__ |
| /* By default, DJGPP provides this type as a version of 'unsigned long' which |
| forces us to use a define use it in printf() format strings without |
| warnings. long and int are both 32 bits for this platform. */ |
| #define uint32_t unsigned int |
| #endif |
| |
| /* Disable uintptr_t for targets known to miss it from stdint.h */ |
| #ifdef __OS400__ |
| #undef HAVE_UINTPTR_T |
| #endif |
| |
| #include <limits.h> |
| |
| /* Default Windows file API selection. */ |
| #ifdef _WIN32 |
| # if defined(_MSC_VER) && (_INTEGRAL_MAX_BITS >= 64) |
| # define USE_WIN32_LARGE_FILES |
| # elif defined(__MINGW32__) |
| # define USE_WIN32_LARGE_FILES |
| # else |
| # define USE_WIN32_SMALL_FILES |
| # endif |
| #endif |
| |
| #ifdef _WIN32 |
| # ifdef HAVE_IO_H |
| # include <io.h> |
| # endif |
| # include <sys/types.h> |
| # include <sys/stat.h> |
| /* Large file (>2Gb) support using Win32 functions. */ |
| # define curl_lseek _lseeki64 |
| # define LSEEK_ERROR ((__int64)-1) |
| #elif defined(__DJGPP__) |
| /* Requires DJGPP 2.04 */ |
| # include <unistd.h> |
| # define curl_lseek llseek |
| # define LSEEK_ERROR ((offset_t)-1) |
| #elif defined(__AMIGA__) |
| # define curl_lseek(fd, offset, whence) lseek(fd, (off_t)(offset), whence) |
| # define LSEEK_ERROR ((off_t)-1) |
| #else |
| # define curl_lseek lseek |
| # define LSEEK_ERROR ((off_t)-1) |
| #endif |
| |
| #ifndef SIZEOF_TIME_T |
| /* assume default size of time_t to be 32 bits */ |
| #define SIZEOF_TIME_T 4 |
| #endif |
| |
| #ifndef SIZEOF_CURL_SOCKET_T |
| /* configure and cmake check and set the define */ |
| # if defined(USE_WINSOCK) && defined(_WIN64) |
| # define SIZEOF_CURL_SOCKET_T 8 |
| # else |
| /* default guess */ |
| # define SIZEOF_CURL_SOCKET_T 4 |
| # endif |
| #endif |
| |
| #if SIZEOF_CURL_SOCKET_T < 8 |
| #ifdef USE_WINSOCK |
| # define FMT_SOCKET_T "u" |
| #else |
| # define FMT_SOCKET_T "d" |
| #endif |
| #elif defined(USE_WINSOCK) |
| # define FMT_SOCKET_T "zu" |
| #else |
| # define FMT_SOCKET_T "qd" |
| #endif |
| |
| /* |
| * Default sizeof(off_t) in case it has not been defined in config file. |
| */ |
| |
| #ifndef SIZEOF_OFF_T |
| # if defined(__VMS) && !defined(__VAX) |
| # ifdef _LARGEFILE |
| # define SIZEOF_OFF_T 8 |
| # endif |
| # elif defined(__OS400__) && defined(__ILEC400__) |
| # ifdef _LARGE_FILES |
| # define SIZEOF_OFF_T 8 |
| # endif |
| # elif defined(__MVS__) && defined(__IBMC__) |
| # if defined(_LP64) || defined(_LARGE_FILES) |
| # define SIZEOF_OFF_T 8 |
| # endif |
| # elif defined(__370__) && defined(__IBMC__) |
| # if defined(_LP64) || defined(_LARGE_FILES) |
| # define SIZEOF_OFF_T 8 |
| # endif |
| # endif |
| # ifndef SIZEOF_OFF_T |
| # define SIZEOF_OFF_T 4 |
| # endif |
| #endif |
| |
| #if (SIZEOF_CURL_OFF_T < 8) |
| #error "too small curl_off_t" |
| #else |
| /* assume SIZEOF_CURL_OFF_T == 8 */ |
| # define CURL_OFF_T_MAX 0x7FFFFFFFFFFFFFFF |
| #endif |
| #define CURL_OFF_T_MIN (-CURL_OFF_T_MAX - 1) |
| |
| #define FMT_OFF_T CURL_FORMAT_CURL_OFF_T |
| #define FMT_OFF_TU CURL_FORMAT_CURL_OFF_TU |
| |
| #if (SIZEOF_TIME_T == 4) |
| # ifdef HAVE_TIME_T_UNSIGNED |
| # define TIME_T_MAX UINT_MAX |
| # define TIME_T_MIN 0 |
| # else |
| # define TIME_T_MAX INT_MAX |
| # define TIME_T_MIN INT_MIN |
| # endif |
| #else |
| # ifdef HAVE_TIME_T_UNSIGNED |
| # define TIME_T_MAX 0xFFFFFFFFFFFFFFFF |
| # define TIME_T_MIN 0 |
| # else |
| # define TIME_T_MAX 0x7FFFFFFFFFFFFFFF |
| # define TIME_T_MIN (-TIME_T_MAX - 1) |
| # endif |
| #endif |
| |
| #ifndef SIZE_MAX |
| /* some limits.h headers have this defined, some do not */ |
| #if defined(SIZEOF_SIZE_T) && (SIZEOF_SIZE_T > 4) |
| #define SIZE_MAX 18446744073709551615U |
| #else |
| #define SIZE_MAX 4294967295U |
| #endif |
| #endif |
| |
| #ifndef SSIZE_MAX |
| /* some limits.h headers have this defined, some do not */ |
| #if defined(SIZEOF_SIZE_T) && (SIZEOF_SIZE_T > 4) |
| #define SSIZE_MAX 9223372036854775807 |
| #else |
| #define SSIZE_MAX 2147483647 |
| #endif |
| #endif |
| |
| #if SIZEOF_LONG > SIZEOF_SIZE_T |
| #error "unexpected: 'long' is larger than 'size_t'" |
| #endif |
| |
| /* |
| * Arg 2 type for gethostname in case it has not been defined in config file. |
| */ |
| #ifndef GETHOSTNAME_TYPE_ARG2 |
| # ifdef USE_WINSOCK |
| # define GETHOSTNAME_TYPE_ARG2 int |
| # else |
| # define GETHOSTNAME_TYPE_ARG2 size_t |
| # endif |
| #endif |
| |
| /* Below we define some functions. They should |
| 4. set the SIGALRM signal timeout |
| 5. set dir/file naming defines |
| */ |
| |
| #ifdef _WIN32 |
| |
| # define DIR_CHAR "\\" |
| |
| #else /* _WIN32 */ |
| |
| # ifdef MSDOS /* Watt-32 */ |
| |
| # include <sys/ioctl.h> |
| # define select(n, r, w, x, t) select_s(n, r, w, x, t) |
| # define ioctl(x, y, z) ioctlsocket(x, y, (char *)(z)) |
| # include <tcp.h> |
| # undef word |
| # undef byte |
| |
| # endif /* MSDOS */ |
| |
| # ifdef __minix |
| /* Minix 3 versions up to at least 3.1.3 are missing these prototypes */ |
| extern struct tm *gmtime_r(const time_t * const timep, struct tm *tmp); |
| # endif |
| |
| # define DIR_CHAR "/" |
| |
| #endif /* _WIN32 */ |
| |
| /* We want to use mutex when available. */ |
| #if defined(HAVE_THREADS_POSIX) || defined(_WIN32) |
| #define USE_MUTEX |
| #endif |
| |
| /* threaded resolver is the only feature requiring threads. */ |
| #ifdef USE_RESOLV_THREADED |
| #define USE_THREADS |
| #endif |
| |
| /* ---------------------------------------------------------------- */ |
| /* resolver specialty compile-time defines */ |
| /* CURLRES_* defines to use in the host*.c sources */ |
| /* ---------------------------------------------------------------- */ |
| |
| /* |
| * Mutually exclusive CURLRES_* definitions. |
| */ |
| #if defined(USE_IPV6) && defined(HAVE_GETADDRINFO) |
| # define CURLRES_IPV6 |
| #elif defined(USE_IPV6) && (defined(_WIN32) || defined(__CYGWIN__)) |
| /* assume on Windows that IPv6 without getaddrinfo is a broken build */ |
| # error "Unexpected build: IPv6 is enabled but getaddrinfo was not found." |
| #else |
| # define CURLRES_IPV4 |
| #endif |
| |
| #ifdef USE_RESOLV_THREADED |
| # define CURLRES_ASYNCH |
| #elif defined(USE_RESOLV_ARES) |
| # define CURLRES_ASYNCH |
| /* now undef the stock libc functions to avoid them being used */ |
| # undef HAVE_GETADDRINFO |
| # undef HAVE_FREEADDRINFO |
| #else |
| # define CURLRES_SYNCH |
| #endif |
| |
| /* ---------------------------------------------------------------- */ |
| |
| #if defined(HAVE_LIBIDN2) && defined(HAVE_IDN2_H) && \ |
| !defined(USE_WIN32_IDN) && !defined(USE_APPLE_IDN) |
| /* The lib and header are present */ |
| #define USE_LIBIDN2 |
| #endif |
| |
| #if defined(USE_LIBIDN2) && (defined(USE_WIN32_IDN) || defined(USE_APPLE_IDN)) |
| #error "libidn2 cannot be enabled with WinIDN or AppleIDN, choose one." |
| #endif |
| |
| #if defined(USE_GNUTLS) || defined(USE_OPENSSL) || defined(USE_MBEDTLS) || \ |
| defined(USE_WOLFSSL) || defined(USE_SCHANNEL) || defined(USE_RUSTLS) |
| #define USE_SSL /* SSL support has been enabled */ |
| #endif |
| |
| #if defined(USE_OPENSSL) && defined(USE_WOLFSSL) |
| #ifndef OPENSSL_COEXIST |
| #define OPENSSL_COEXIST |
| #endif |
| #endif |
| |
| #if defined(USE_WOLFSSL) && defined(USE_GNUTLS) |
| /* Avoid defining unprefixed wolfSSL SHA macros colliding with nettle ones */ |
| #define NO_OLD_WC_NAMES |
| #endif |
| |
| /* Single point where USE_SPNEGO definition might be defined */ |
| #if !defined(CURL_DISABLE_NEGOTIATE_AUTH) && \ |
| (defined(HAVE_GSSAPI) || defined(USE_WINDOWS_SSPI)) |
| #define USE_SPNEGO |
| #endif |
| |
| /* Single point where USE_KERBEROS5 definition might be defined */ |
| #if !defined(CURL_DISABLE_KERBEROS_AUTH) && \ |
| (defined(HAVE_GSSAPI) || defined(USE_WINDOWS_SSPI)) |
| #define USE_KERBEROS5 |
| #endif |
| |
| /* Single point where USE_NTLM definition might be defined */ |
| #ifdef CURL_ENABLE_NTLM |
| # if (defined(USE_OPENSSL) && defined(HAVE_DES_ECB_ENCRYPT)) || \ |
| defined(USE_GNUTLS) || \ |
| (defined(USE_MBEDTLS) && defined(HAVE_MBEDTLS_DES_CRYPT_ECB)) || \ |
| defined(USE_OS400CRYPTO) || defined(USE_WIN32_CRYPTO) || \ |
| (defined(USE_WOLFSSL) && defined(HAVE_WC_DES_ECBENCRYPT)) |
| # define USE_CURL_NTLM_CORE |
| # endif |
| # if defined(USE_CURL_NTLM_CORE) || defined(USE_WINDOWS_SSPI) |
| # define USE_NTLM |
| # endif |
| #endif |
| |
| #if defined(USE_LIBSSH2) || defined(USE_LIBSSH) |
| #define USE_SSH |
| #endif |
| |
| /* GCC <4.6 does not support '#pragma GCC diagnostic push' and does not support |
| 'pragma GCC diagnostic' inside functions. |
| Use CURL_HAVE_DIAG to guard the above in the curl codebase, instead of |
| defined(__GNUC__) || defined(__clang__). |
| */ |
| #if defined(__clang__) || (defined(__GNUC__) && \ |
| ((__GNUC__ > 4) || ((__GNUC__ == 4) && (__GNUC_MINOR__ >= 6)))) |
| #define CURL_HAVE_DIAG |
| #endif |
| |
| /* |
| * Provide a mechanism to silence picky compilers, such as gcc 4.6+. |
| * Parameters should of course normally not be unused, but for example when |
| * we have multiple implementations of the same interface it may happen. |
| */ |
| #if defined(__GNUC__) && ((__GNUC__ >= 3) || \ |
| ((__GNUC__ == 2) && defined(__GNUC_MINOR__) && (__GNUC_MINOR__ >= 7))) |
| # define WARN_UNUSED_RESULT __attribute__((warn_unused_result)) |
| #elif defined(__IAR_SYSTEMS_ICC__) && (__VER__ >= 9040001) |
| # define WARN_UNUSED_RESULT __attribute__((warn_unused_result)) |
| #else |
| # define WARN_UNUSED_RESULT |
| #endif |
| |
| /* noreturn attribute */ |
| |
| #ifndef CURL_NORETURN |
| #if (defined(__GNUC__) && (__GNUC__ >= 3)) || defined(__clang__) || \ |
| defined(__IAR_SYSTEMS_ICC__) |
| # define CURL_NORETURN __attribute__((__noreturn__)) |
| #elif defined(_MSC_VER) |
| # define CURL_NORETURN __declspec(noreturn) |
| #else |
| # define CURL_NORETURN |
| #endif |
| #endif |
| |
| /* fallthrough attribute */ |
| |
| #ifndef FALLTHROUGH |
| #if (defined(__GNUC__) && __GNUC__ >= 7) || \ |
| (defined(__clang__) && __clang_major__ >= 10) |
| # define FALLTHROUGH() __attribute__((fallthrough)) |
| #else |
| # define FALLTHROUGH() do {} while(0) |
| #endif |
| #endif |
| |
| /* |
| * Inclusion of common header files. |
| */ |
| |
| #include <stdlib.h> |
| #include <string.h> |
| #include <stdarg.h> |
| #include <time.h> |
| #include <errno.h> |
| |
| #ifdef HAVE_SYS_TYPES_H |
| #include <sys/types.h> |
| #endif |
| |
| #include <sys/stat.h> |
| |
| #if !defined(_WIN32) || defined(__MINGW32__) |
| #include <sys/time.h> |
| #endif |
| |
| #ifdef HAVE_IO_H |
| #include <io.h> |
| #endif |
| |
| #ifdef HAVE_FCNTL_H |
| #include <fcntl.h> |
| #endif |
| |
| #if defined(HAVE_STDBOOL_H) && defined(HAVE_BOOL_T) |
| #include <stdbool.h> |
| #endif |
| |
| #ifdef HAVE_UNISTD_H |
| #include <unistd.h> |
| #endif |
| |
| /* Macro to strip 'const' without triggering a compiler warning. |
| Use it for APIs that do not or cannot support the const qualifier. */ |
| #ifdef HAVE_UINTPTR_T |
| #define CURL_UNCONST(p) ((void *)(uintptr_t)(const void *)(p)) |
| #else |
| #define CURL_UNCONST(p) ((void *)(p)) /* Fall back to simple cast */ |
| #endif |
| |
| #ifdef USE_SCHANNEL |
| /* Must set this before <schannel.h> is included directly or indirectly by |
| another Windows header. */ |
| # define SCHANNEL_USE_BLACKLISTS /* for SCH_CREDENTIALS */ |
| # include <subauth.h> /* for [P]UNICODE_STRING in SCH_CREDENTIALS */ |
| #endif |
| |
| #ifdef __hpux |
| # if !defined(_XOPEN_SOURCE_EXTENDED) || defined(_KERNEL) |
| # ifdef _APP32_64BIT_OFF_T |
| # define OLD_APP32_64BIT_OFF_T _APP32_64BIT_OFF_T |
| # undef _APP32_64BIT_OFF_T |
| # else |
| # undef OLD_APP32_64BIT_OFF_T |
| # endif |
| # endif |
| #endif |
| |
| #ifndef _WIN32 |
| #include <sys/socket.h> /* also for MSG_NOSIGNAL */ |
| #endif |
| |
| #include "functypes.h" |
| |
| #ifdef __hpux |
| # if !defined(_XOPEN_SOURCE_EXTENDED) || defined(_KERNEL) |
| # ifdef OLD_APP32_64BIT_OFF_T |
| # define _APP32_64BIT_OFF_T OLD_APP32_64BIT_OFF_T |
| # undef OLD_APP32_64BIT_OFF_T |
| # endif |
| # endif |
| #endif |
| |
| /* |
| * Definition of timeval struct for platforms that do not have it. |
| */ |
| #ifndef HAVE_STRUCT_TIMEVAL |
| struct timeval { |
| long tv_sec; |
| long tv_usec; |
| }; |
| #endif |
| |
| /* |
| * If we have the MSG_NOSIGNAL define, make sure we use |
| * it as the fourth argument of function send() |
| */ |
| #ifdef MSG_NOSIGNAL |
| #define SEND_4TH_ARG MSG_NOSIGNAL |
| #else |
| #define SEND_4TH_ARG 0 |
| #endif |
| |
| #ifdef __minix |
| /* Minix does not support recv on TCP sockets */ |
| #define sread(x, y, z) (ssize_t)read((RECV_TYPE_ARG1)(x), \ |
| (RECV_TYPE_ARG2)(y), \ |
| (RECV_TYPE_ARG3)(z)) |
| |
| #elif defined(HAVE_RECV) |
| /* |
| * The definitions for the return type and arguments types |
| * of functions recv() and send() belong and come from the |
| * configuration file. Do not define them in any other place. |
| * |
| * HAVE_RECV is defined if you have a function named recv() |
| * which is used to read incoming data from sockets. If your |
| * function has another name then do not define HAVE_RECV. |
| * |
| * If HAVE_RECV is defined then RECV_TYPE_ARG1, RECV_TYPE_ARG2, |
| * RECV_TYPE_ARG3, RECV_TYPE_ARG4 and RECV_TYPE_RETV must also |
| * be defined. |
| * |
| * HAVE_SEND is defined if you have a function named send() |
| * which is used to write outgoing data on a connected socket. |
| * If yours has another name then do not define HAVE_SEND. |
| * |
| * If HAVE_SEND is defined then SEND_TYPE_ARG1, SEND_TYPE_ARG2, |
| * SEND_TYPE_ARG3, SEND_TYPE_ARG4 and SEND_TYPE_RETV must also |
| * be defined. SEND_NONCONST_ARG2 must also be defined if ARG2 |
| * does not accept const. |
| */ |
| |
| #define sread(x, y, z) (ssize_t)recv((RECV_TYPE_ARG1)(x), \ |
| (RECV_TYPE_ARG2)(y), \ |
| (RECV_TYPE_ARG3)(z), \ |
| (RECV_TYPE_ARG4)(0)) |
| #else /* HAVE_RECV */ |
| #ifndef sread |
| #error "Missing definition of macro sread!" |
| #endif |
| #endif /* HAVE_RECV */ |
| |
| #ifdef __minix |
| /* Minix does not support send on TCP sockets */ |
| #define swrite(x, y, z) (ssize_t)write((SEND_TYPE_ARG1)(x), \ |
| (SEND_TYPE_ARG2)CURL_UNCONST(y), \ |
| (SEND_TYPE_ARG3)(z)) |
| #elif defined(HAVE_SEND) |
| #ifdef SEND_NONCONST_ARG2 |
| #define swrite(x, y, z) (ssize_t)send((SEND_TYPE_ARG1)(x), \ |
| (SEND_TYPE_ARG2)CURL_UNCONST(y), \ |
| (SEND_TYPE_ARG3)(z), \ |
| (SEND_TYPE_ARG4)(SEND_4TH_ARG)) |
| #else |
| #define swrite(x, y, z) (ssize_t)send((SEND_TYPE_ARG1)(x), \ |
| (const SEND_TYPE_ARG2)(y), \ |
| (SEND_TYPE_ARG3)(z), \ |
| (SEND_TYPE_ARG4)(SEND_4TH_ARG)) |
| #endif /* SEND_NONCONST_ARG2 */ |
| #else /* HAVE_SEND */ |
| #ifndef swrite |
| #error "Missing definition of macro swrite!" |
| #endif |
| #endif /* HAVE_SEND */ |
| |
| /* |
| * Function-like macro definition used to close a socket. |
| */ |
| #ifdef HAVE_CLOSESOCKET |
| # define CURL_SCLOSE(x) closesocket(x) |
| #elif defined(HAVE_CLOSESOCKET_CAMEL) |
| # define CURL_SCLOSE(x) CloseSocket(x) |
| #elif defined(MSDOS) /* Watt-32 */ |
| # define CURL_SCLOSE(x) close_s(x) |
| #elif defined(USE_LWIPSOCK) |
| # define CURL_SCLOSE(x) lwip_close(x) |
| #else |
| # define CURL_SCLOSE(x) close(x) |
| #endif |
| |
| /* |
| * Stack-independent version of fcntl() on sockets: |
| */ |
| #ifdef USE_LWIPSOCK |
| # define sfcntl lwip_fcntl |
| #else |
| # define sfcntl fcntl |
| #endif |
| |
| /* |
| * 'bool' stuff compatible with HP-UX headers. |
| */ |
| #if defined(__hpux) && !defined(HAVE_BOOL_T) |
| typedef int bool; |
| # define false 0 |
| # define true 1 |
| # define HAVE_BOOL_T |
| #endif |
| |
| /* |
| * 'bool' exists on platforms with <stdbool.h>, i.e. C99 platforms. |
| * On non-C99 platforms there is no bool, so define an enum for that. |
| * On C99 platforms 'false' and 'true' also exist. Enum uses a |
| * global namespace though, so use bool_false and bool_true. |
| */ |
| #ifndef HAVE_BOOL_T |
| typedef enum { |
| bool_false = 0, |
| bool_true = 1 |
| } bool; |
| |
| /* |
| * Use a define to let 'true' and 'false' use those enums. There |
| * are currently no use of true and false in libcurl proper, but |
| * there are some in the examples. This will cater for any later |
| * code happening to use true and false. |
| */ |
| # define false bool_false |
| # define true bool_true |
| # define HAVE_BOOL_T |
| #endif |
| |
| /* the type we use for storing a single boolean bit */ |
| typedef unsigned int curl_bit; |
| #define BIT(x) curl_bit x:1 |
| |
| /* |
| * Redefine TRUE and FALSE too, to catch current use. With this |
| * change, 'bool found = 1' will give a warning on MIPSPro, but |
| * 'bool found = TRUE' will not. Change tested on IRIX/MIPSPro, |
| * AIX 5.1/Xlc, Tru64 5.1/cc, w/make test too. |
| */ |
| #ifndef TRUE |
| #define TRUE true |
| #endif |
| #ifndef FALSE |
| #define FALSE false |
| #endif |
| |
| #include "curl_ctype.h" |
| |
| /* |
| * Macro used to include code only in debug builds. |
| */ |
| #ifdef DEBUGBUILD |
| #define DEBUGF(x) x |
| #else |
| #define DEBUGF(x) do {} while(0) |
| #endif |
| |
| /* |
| * Macro used to include assertion code only in debug builds. |
| */ |
| #undef DEBUGASSERT |
| #ifdef DEBUGBUILD |
| #ifdef CURL_DEBUGASSERT |
| /* External assertion handler for custom integrations */ |
| #define DEBUGASSERT(x) CURL_DEBUGASSERT(x) |
| #else |
| #define DEBUGASSERT(x) assert(x) |
| #endif |
| #else |
| #define DEBUGASSERT(x) do {} while(0) |
| #endif |
| |
| /* |
| * Macro SOCKERRNO / SET_SOCKERRNO() returns / sets the *socket-related* errno |
| * (or equivalent) on this platform to hide platform details to code using it. |
| */ |
| #ifdef USE_WINSOCK |
| #define SOCKERRNO ((int)WSAGetLastError()) |
| #define SET_SOCKERRNO(x) WSASetLastError((int)(x)) |
| #else |
| #define SOCKERRNO errno |
| #define SET_SOCKERRNO(x) (errno = (x)) |
| #endif |
| |
| /* |
| * Portable error number symbolic names defined to Winsock error codes. |
| */ |
| #ifdef USE_WINSOCK |
| #define SOCKEACCES WSAEACCES |
| #define SOCKEADDRINUSE WSAEADDRINUSE |
| #define SOCKEADDRNOTAVAIL WSAEADDRNOTAVAIL |
| #define SOCKEAFNOSUPPORT WSAEAFNOSUPPORT |
| #define SOCKEBADF WSAEBADF |
| #define SOCKECONNREFUSED WSAECONNREFUSED |
| #define SOCKECONNRESET WSAECONNRESET |
| #define SOCKEINPROGRESS WSAEINPROGRESS |
| #define SOCKEINTR WSAEINTR |
| #define SOCKEINVAL WSAEINVAL |
| #define SOCKEISCONN WSAEISCONN |
| #define SOCKEMSGSIZE WSAEMSGSIZE |
| /* Use literal value to work around clang-tidy <=20 misreporting |
| 'readability-uppercase-literal-suffix' with mingw-w64 headers */ |
| #define SOCKENOMEM 8L /* WSA_NOT_ENOUGH_MEMORY */ |
| #define SOCKETIMEDOUT WSAETIMEDOUT |
| #define SOCKEWOULDBLOCK WSAEWOULDBLOCK |
| #else |
| #define SOCKEACCES EACCES |
| #define SOCKEADDRINUSE EADDRINUSE |
| #define SOCKEADDRNOTAVAIL EADDRNOTAVAIL |
| #define SOCKEAFNOSUPPORT EAFNOSUPPORT |
| #define SOCKEBADF EBADF |
| #define SOCKECONNREFUSED ECONNREFUSED |
| #define SOCKECONNRESET ECONNRESET |
| #define SOCKEINPROGRESS EINPROGRESS |
| #define SOCKEINTR EINTR |
| #define SOCKEINVAL EINVAL |
| #define SOCKEISCONN EISCONN |
| #define SOCKEMSGSIZE EMSGSIZE |
| #define SOCKENOMEM ENOMEM |
| #ifdef ETIMEDOUT |
| #define SOCKETIMEDOUT ETIMEDOUT |
| #endif |
| #define SOCKEWOULDBLOCK EWOULDBLOCK |
| #endif |
| |
| /* |
| * Macro argv_item_t hides platform details to code using it. |
| */ |
| #ifdef __VMS |
| #define argv_item_t __char_ptr32 |
| #elif defined(_UNICODE) |
| #define argv_item_t wchar_t * |
| #else |
| #define argv_item_t char * |
| #endif |
| |
| /* |
| * We use this ZERO_NULL to avoid picky compiler warnings, |
| * when assigning a NULL pointer to a function pointer var. |
| */ |
| #define ZERO_NULL 0 |
| |
| /* |
| * Macros and functions to safely suppress warnings |
| */ |
| #include "curlx/warnless.h" |
| |
| #ifdef _WIN32 |
| # undef read |
| # define read(fd, buf, count) (ssize_t)_read(fd, buf, curlx_uztoui(count)) |
| # undef write |
| # define write(fd, buf, count) (ssize_t)_write(fd, buf, curlx_uztoui(count)) |
| /* Avoid VS2005+ _CRT_NONSTDC_NO_DEPRECATE warnings about non-portable funcs */ |
| # undef fileno |
| # define fileno(fh) _fileno(fh) |
| # undef unlink |
| # define unlink(fn) _unlink(fn) |
| # undef isatty |
| # define isatty(fd) _isatty(fd) |
| #endif |
| |
| /* |
| * Definition of our NOP statement Object-like macro |
| */ |
| #ifndef Curl_nop_stmt |
| #define Curl_nop_stmt do {} while(0) |
| #endif |
| |
| /* |
| * Ensure that Winsock and lwIP TCP/IP stacks are not mixed. |
| */ |
| #if defined(__LWIP_OPT_H__) || defined(LWIP_HDR_OPT_H) |
| # if defined(SOCKET) || defined(USE_WINSOCK) |
| # error "Winsock and lwIP TCP/IP stack definitions shall not coexist!" |
| # endif |
| #endif |
| |
| /* |
| * shutdown() flags for systems that do not define them |
| */ |
| #ifndef SHUT_RD |
| #define SHUT_RD 0x00 |
| #endif |
| |
| #ifndef SHUT_WR |
| #define SHUT_WR 0x01 |
| #endif |
| |
| #ifndef SHUT_RDWR |
| #define SHUT_RDWR 0x02 |
| #endif |
| |
| /* Define S_ISREG if not defined by system headers, e.g. MSVC */ |
| #if !defined(S_ISREG) && defined(S_IFMT) && defined(S_IFREG) |
| #define S_ISREG(m) (((m) & S_IFMT) == S_IFREG) |
| #endif |
| |
| /* Define S_ISDIR if not defined by system headers, e.g. MSVC */ |
| #if !defined(S_ISDIR) && defined(S_IFMT) && defined(S_IFDIR) |
| #define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR) |
| #endif |
| |
| /* For MSVC (all versions as of VS2022) */ |
| #ifndef STDIN_FILENO |
| #define STDIN_FILENO fileno(stdin) |
| #endif |
| #ifndef STDOUT_FILENO |
| #define STDOUT_FILENO fileno(stdout) |
| #endif |
| #ifndef STDERR_FILENO |
| #define STDERR_FILENO fileno(stderr) |
| #endif |
| |
| /* Since O_BINARY is used in bitmasks, setting it to zero makes it usable in |
| source code but yet it does not ruin anything */ |
| #ifdef _O_BINARY /* for _WIN32 || MSDOS */ |
| #define CURL_O_BINARY _O_BINARY |
| #elif defined(O_BINARY) /* __CYGWIN__ */ |
| #define CURL_O_BINARY O_BINARY |
| #else |
| #define CURL_O_BINARY 0 |
| #endif |
| |
| /* Requires io.h when available */ |
| #ifdef MSDOS |
| #define CURL_BINMODE(stream) (void)setmode(fileno(stream), CURL_O_BINARY) |
| #elif defined(_WIN32) || defined(__CYGWIN__) |
| #define CURL_BINMODE(stream) (void)_setmode(fileno(stream), CURL_O_BINARY) |
| #else |
| #define CURL_BINMODE(stream) (void)(stream) |
| #endif |
| |
| /* In Windows the default file mode is text but an application can override it. |
| Therefore we specify it explicitly. https://github.com/curl/curl/pull/258 |
| */ |
| #if defined(_WIN32) || defined(MSDOS) |
| #define FOPEN_READTEXT "rt" |
| #define FOPEN_WRITETEXT "wt" |
| #define FOPEN_APPENDTEXT "at" |
| #elif defined(__CYGWIN__) |
| /* Cygwin has specific behavior we need to address when _WIN32 is not defined. |
| https://cygwin.com/cygwin-ug-net/using-textbinary.html |
| For write we want our output to have line endings of LF and be compatible with |
| other Cygwin utilities. For read we want to handle input that may have line |
| endings either CRLF or LF so 't' is appropriate. |
| */ |
| #define FOPEN_READTEXT "rt" |
| #define FOPEN_WRITETEXT "w" |
| #define FOPEN_APPENDTEXT "a" |
| #else |
| #define FOPEN_READTEXT "r" |
| #define FOPEN_WRITETEXT "w" |
| #define FOPEN_APPENDTEXT "a" |
| #endif |
| |
| /* for systems that do not detect this in configure */ |
| #ifndef CURL_SA_FAMILY_T |
| # ifdef USE_WINSOCK |
| # define CURL_SA_FAMILY_T ADDRESS_FAMILY |
| # elif defined(HAVE_SA_FAMILY_T) |
| # define CURL_SA_FAMILY_T sa_family_t |
| # elif defined(__AMIGA__) |
| # define CURL_SA_FAMILY_T unsigned char |
| # else |
| /* use a sensible default */ |
| # define CURL_SA_FAMILY_T unsigned short |
| # endif |
| #endif |
| |
| /* Some convenience macros to get the larger/smaller value out of two given. |
| We prefix with CURL to prevent name collisions. */ |
| #define CURLMAX(x, y) ((x) > (y) ? (x) : (y)) |
| #define CURLMIN(x, y) ((x) < (y) ? (x) : (y)) |
| |
| /* A convenience macro to provide both the string literal and the length of |
| the string literal in one go, useful for functions that take "string,len" |
| as their argument */ |
| #define STRCONST(x) x, sizeof(x) - 1 |
| |
| #define CURL_ARRAYSIZE(A) (sizeof(A) / sizeof((A)[0])) |
| |
| /* Buffer size for error messages retrieved via |
| curlx_strerror() and Curl_sspi_strerror() */ |
| #define STRERROR_LEN 256 |
| |
| #ifndef CURL_DID_MEMORY_FUNC_TYPEDEFS /* only if not already done */ |
| /* |
| * The following memory function replacement typedef's are COPIED from |
| * curl/curl.h and MUST match the originals. We copy them to avoid having to |
| * include curl/curl.h here. We avoid that include since it includes stdio.h |
| * and other headers that may get messed up with defines done here. |
| */ |
| typedef void *(*curl_malloc_callback)(size_t size); |
| typedef void (*curl_free_callback)(void *ptr); |
| typedef void *(*curl_realloc_callback)(void *ptr, size_t size); |
| typedef char *(*curl_strdup_callback)(const char *str); |
| typedef void *(*curl_calloc_callback)(size_t nmemb, size_t size); |
| #define CURL_DID_MEMORY_FUNC_TYPEDEFS |
| #endif |
| |
| extern curl_malloc_callback Curl_cmalloc; |
| extern curl_free_callback Curl_cfree; |
| extern curl_realloc_callback Curl_crealloc; |
| extern curl_strdup_callback Curl_cstrdup; |
| extern curl_calloc_callback Curl_ccalloc; |
| |
| /* |
| * curlx_safefree() defined as a macro to allow MemoryTracking feature |
| * to log free() calls at same location where curlx_safefree() is used. |
| * This macro also assigns NULL to given pointer when free'd. |
| */ |
| #define curlx_safefree(ptr) \ |
| do { \ |
| curlx_free(ptr); \ |
| (ptr) = NULL; \ |
| } while(0) |
| |
| #include <curl/curl.h> /* for CURL_EXTERN, curl_socket_t, mprintf.h */ |
| |
| #ifdef DEBUGBUILD |
| #define CURL_MEMDEBUG |
| #endif |
| |
| #ifdef CURL_MEMDEBUG |
| #ifdef __clang__ |
| # define ALLOC_FUNC __attribute__((__malloc__)) |
| # if __clang_major__ >= 4 |
| # define ALLOC_SIZE(s) __attribute__((__alloc_size__(s))) |
| # define ALLOC_SIZE2(n, s) __attribute__((__alloc_size__(n, s))) |
| # else |
| # define ALLOC_SIZE(s) |
| # define ALLOC_SIZE2(n, s) |
| # endif |
| #elif defined(__GNUC__) && __GNUC__ >= 3 |
| # define ALLOC_FUNC __attribute__((__malloc__)) |
| # define ALLOC_SIZE(s) __attribute__((__alloc_size__(s))) |
| # define ALLOC_SIZE2(n, s) __attribute__((__alloc_size__(n, s))) |
| #elif defined(_MSC_VER) |
| # define ALLOC_FUNC __declspec(restrict) |
| # define ALLOC_SIZE(s) |
| # define ALLOC_SIZE2(n, s) |
| #else |
| # define ALLOC_FUNC |
| # define ALLOC_SIZE(s) |
| # define ALLOC_SIZE2(n, s) |
| #endif |
| |
| extern FILE *curl_dbg_logfile; |
| |
| /* memory functions */ |
| CURL_EXTERN void curl_dbg_free(void *ptr, int line, const char *source); |
| CURL_EXTERN ALLOC_FUNC ALLOC_SIZE(1) |
| void *curl_dbg_malloc(size_t size, int line, const char *source); |
| CURL_EXTERN ALLOC_FUNC ALLOC_SIZE2(1, 2) |
| void *curl_dbg_calloc(size_t n, size_t size, int line, const char *source); |
| CURL_EXTERN ALLOC_SIZE(2) |
| void *curl_dbg_realloc(void *ptr, size_t size, int line, const char *source); |
| CURL_EXTERN ALLOC_FUNC |
| char *curl_dbg_strdup(const char *str, int line, const char *src); |
| #if defined(_WIN32) && defined(UNICODE) |
| CURL_EXTERN ALLOC_FUNC |
| wchar_t *curl_dbg_wcsdup(const wchar_t *str, int line, const char *source); |
| #endif |
| |
| CURL_EXTERN void curl_dbg_memdebug(const char *logname); |
| CURL_EXTERN void curl_dbg_memlimit(long limit); |
| CURL_EXTERN void curl_dbg_log(const char *format, ...) CURL_PRINTF(1, 2); |
| |
| /* file descriptor manipulators */ |
| CURL_EXTERN curl_socket_t curl_dbg_socket(int domain, int type, int protocol, |
| int line, const char *source); |
| CURL_EXTERN void curl_dbg_mark_sclose(curl_socket_t sockfd, |
| int line, const char *source); |
| CURL_EXTERN int curl_dbg_sclose(curl_socket_t sockfd, |
| int line, const char *source); |
| CURL_EXTERN curl_socket_t curl_dbg_accept(curl_socket_t s, |
| void *saddr, void *saddrlen, |
| int line, const char *source); |
| #ifdef HAVE_ACCEPT4 |
| CURL_EXTERN curl_socket_t curl_dbg_accept4(curl_socket_t s, void *saddr, |
| void *saddrlen, int flags, |
| int line, const char *source); |
| #endif |
| #ifdef HAVE_SOCKETPAIR |
| CURL_EXTERN int curl_dbg_socketpair(int domain, int type, int protocol, |
| curl_socket_t socket_vector[2], |
| int line, const char *source); |
| #endif |
| |
| /* FILE functions */ |
| CURL_EXTERN int curl_dbg_fclose(FILE *file, int line, const char *source); |
| CURL_EXTERN ALLOC_FUNC FILE *curl_dbg_fopen(const char *file, const char *mode, |
| int line, const char *source); |
| CURL_EXTERN ALLOC_FUNC FILE *curl_dbg_freopen(const char *file, |
| const char *mode, FILE *fh, |
| int line, const char *source); |
| CURL_EXTERN ALLOC_FUNC FILE *curl_dbg_fdopen(int filedes, const char *mode, |
| int line, const char *source); |
| |
| #define sclose(sockfd) curl_dbg_sclose(sockfd, __LINE__, __FILE__) |
| #define fake_sclose(sockfd) curl_dbg_mark_sclose(sockfd, __LINE__, __FILE__) |
| |
| #define CURL_GETADDRINFO(host, serv, hint, res) \ |
| curl_dbg_getaddrinfo(host, serv, hint, res, __LINE__, __FILE__) |
| #define CURL_FREEADDRINFO(data) \ |
| curl_dbg_freeaddrinfo(data, __LINE__, __FILE__) |
| #define CURL_SOCKET(domain, type, protocol) \ |
| curl_dbg_socket((int)(domain), type, protocol, __LINE__, __FILE__) |
| #ifdef HAVE_SOCKETPAIR |
| #define CURL_SOCKETPAIR(domain, type, protocol, socket_vector) \ |
| curl_dbg_socketpair((int)(domain), type, protocol, socket_vector, \ |
| __LINE__, __FILE__) |
| #endif |
| #define CURL_ACCEPT(sock, addr, len) \ |
| curl_dbg_accept(sock, addr, len, __LINE__, __FILE__) |
| #ifdef HAVE_ACCEPT4 |
| #define CURL_ACCEPT4(sock, addr, len, flags) \ |
| curl_dbg_accept4(sock, addr, len, flags, __LINE__, __FILE__) |
| #endif |
| |
| #else /* !CURL_MEMDEBUG */ |
| |
| #define sclose(x) CURL_SCLOSE(x) |
| #define fake_sclose(x) Curl_nop_stmt |
| |
| #define CURL_GETADDRINFO getaddrinfo |
| #define CURL_FREEADDRINFO freeaddrinfo |
| #define CURL_SOCKET socket |
| #ifdef HAVE_SOCKETPAIR |
| #define CURL_SOCKETPAIR socketpair |
| #endif |
| #define CURL_ACCEPT accept |
| #ifdef HAVE_ACCEPT4 |
| #define CURL_ACCEPT4 accept4 |
| #endif |
| |
| #endif /* CURL_MEMDEBUG */ |
| |
| /* Allocator macros */ |
| |
| #ifdef _WIN32 |
| #define CURLX_STRDUP_LOW _strdup |
| #else |
| #define CURLX_STRDUP_LOW strdup |
| #endif |
| |
| #ifdef CURL_MEMDEBUG |
| |
| #define curlx_strdup(ptr) curl_dbg_strdup(ptr, __LINE__, __FILE__) |
| #define curlx_malloc(size) curl_dbg_malloc(size, __LINE__, __FILE__) |
| #define curlx_calloc(nbelem, size) \ |
| curl_dbg_calloc(nbelem, size, __LINE__, __FILE__) |
| #define curlx_realloc(ptr, size) \ |
| curl_dbg_realloc(ptr, size, __LINE__, __FILE__) |
| #define curlx_free(ptr) curl_dbg_free(ptr, __LINE__, __FILE__) |
| |
| #ifdef _WIN32 |
| #ifdef UNICODE |
| #define curlx_tcsdup(ptr) curl_dbg_wcsdup(ptr, __LINE__, __FILE__) |
| #else |
| #define curlx_tcsdup curlx_strdup |
| #endif |
| #endif /* _WIN32 */ |
| |
| #else /* !CURL_MEMDEBUG */ |
| |
| #ifdef BUILDING_LIBCURL |
| #define curlx_strdup Curl_cstrdup |
| #define curlx_malloc Curl_cmalloc |
| #define curlx_calloc Curl_ccalloc |
| #define curlx_realloc Curl_crealloc |
| #define curlx_free Curl_cfree |
| #else /* !BUILDING_LIBCURL */ |
| #define curlx_strdup CURLX_STRDUP_LOW |
| #define curlx_malloc malloc |
| #define curlx_calloc calloc |
| #define curlx_realloc realloc |
| #define curlx_free free |
| #endif /* BUILDING_LIBCURL */ |
| |
| #ifdef _WIN32 |
| #ifdef UNICODE |
| #define curlx_tcsdup curlx_wcsdup |
| #else |
| #define curlx_tcsdup curlx_strdup |
| #endif |
| #endif /* _WIN32 */ |
| |
| #endif /* CURL_MEMDEBUG */ |
| |
| /* Some versions of the Android NDK is missing the declaration */ |
| #if defined(HAVE_GETPWUID_R) && \ |
| defined(__ANDROID_API__) && (__ANDROID_API__ < 21) |
| struct passwd; |
| int getpwuid_r(uid_t uid, struct passwd *pwd, char *buf, |
| size_t buflen, struct passwd **result); |
| #endif |
| |
| #ifdef UNITTESTS |
| #define UNITTEST |
| #else |
| #define UNITTEST static |
| #endif |
| |
| #ifdef USE_NGHTTP2 |
| #define USE_HTTP2 |
| #endif |
| |
| #if (defined(USE_NGTCP2) && defined(USE_NGHTTP3)) || defined(USE_QUICHE) |
| |
| #ifdef CURL_WITH_MULTI_SSL |
| #error "MultiSSL combined with QUIC is not supported" |
| #endif |
| |
| #define USE_HTTP3 |
| #endif |
| |
| /* WebAssembly builds have TCP_NODELAY, but runtime support is missing. */ |
| #ifndef __EMSCRIPTEN__ |
| #define CURL_TCP_NODELAY_SUPPORTED |
| #endif |
| |
| /* Certain Windows implementations are not aligned with what curl expects, |
| so always use the local one on this platform. E.g. the mingw-w64 |
| implementation can return wrong results for non-ASCII inputs. */ |
| #if defined(HAVE_BASENAME) && defined(_WIN32) |
| #undef HAVE_BASENAME |
| #endif |
| |
| #if defined(USE_UNIX_SOCKETS) && defined(_WIN32) |
| /* Offered by mingw-w64 v10+. MS SDK 10.17763/~VS2017+. */ |
| #if defined(__MINGW32__) && (__MINGW64_VERSION_MAJOR >= 10) |
| # include <afunix.h> |
| #elif !defined(UNIX_PATH_MAX) /* Replicate logic present in afunix.h */ |
| # define UNIX_PATH_MAX 108 |
| /* !checksrc! disable TYPEDEFSTRUCT 1 */ |
| typedef struct sockaddr_un { |
| CURL_SA_FAMILY_T sun_family; |
| char sun_path[UNIX_PATH_MAX]; |
| } SOCKADDR_UN, *PSOCKADDR_UN; |
| #endif |
| #endif |
| |
| #ifdef USE_OPENSSL |
| /* OpenSSL 3 marks these functions deprecated but we have no replacements (yet) |
| so tell the compiler to not warn for them: |
| - DES_* (for NTLM), SSL_CTX_set_srp_* (for TLS-SRP) |
| - EVP_PKEY_get1_RSA, MD5_*, RSA_flags, RSA_free (auto-skipped for OpenSSL |
| built with no-deprecated) */ |
| # define OPENSSL_SUPPRESS_DEPRECATED |
| # ifdef _WIN32 |
| /* Silence LibreSSL warnings about wincrypt.h collision. Works in 3.8.2+ */ |
| # ifndef LIBRESSL_DISABLE_OVERRIDE_WINCRYPT_DEFINES_WARNING |
| # define LIBRESSL_DISABLE_OVERRIDE_WINCRYPT_DEFINES_WARNING |
| # endif |
| # endif |
| #endif |
| |
| #ifdef CURL_INLINE |
| /* 'CURL_INLINE' defined, use as-is */ |
| #elif defined(inline) |
| # define CURL_INLINE inline /* 'inline' defined, assumed correct */ |
| #elif defined(__cplusplus) |
| /* The code is compiled with C++ compiler. |
| C++ always supports 'inline'. */ |
| # define CURL_INLINE inline /* 'inline' keyword supported */ |
| #elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901 |
| /* C99 (and later) supports 'inline' keyword */ |
| # define CURL_INLINE inline /* 'inline' keyword supported */ |
| #elif defined(__GNUC__) && __GNUC__ >= 3 |
| /* GCC supports '__inline__' as an extension */ |
| # define CURL_INLINE __inline__ |
| #elif defined(_MSC_VER) |
| # define CURL_INLINE __inline |
| #else |
| /* Probably 'inline' is not supported by compiler. |
| Define to the empty string to be on the safe side. */ |
| # define CURL_INLINE /* empty */ |
| #endif |
| |
| /* Detect if compiler supports C99 variadic macros */ |
| #if (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ |
| defined(_MSC_VER) |
| #define CURL_HAVE_MACRO_VARARG |
| #endif |
| |
| #if !defined(CURL_HAVE_MACRO_VARARG) || \ |
| (defined(CURL_HAVE_MACRO_VARARG) && !defined(CURL_DISABLE_VERBOSE_STRINGS)) |
| #define CURLVERBOSE |
| #define VERBOSE(x) x |
| #define NOVERBOSE(x) Curl_nop_stmt |
| #else |
| #define VERBOSE(x) Curl_nop_stmt |
| #define NOVERBOSE(x) x |
| #endif |
| |
| #endif /* HEADER_CURL_SETUP_H */ |