Files
curl/docs/INTERNALS.md
Viktor Szakats b17ef873ae windows: bump minimum to Vista (from XP)
After this patch curl requires targeting Vista or newer, and a toolchain
with Vista support.

Supported MSVC compilers (VS2010+) all support Vista:
- VS2012+ target Win8 (or later) by default.
- VS2010 targets Win7 by default.

Supported mingw-w64 versions (v3+) all support Vista:
- mingw-w64 v9+ target Win10 by default.
- mingw-w64 v8 and older target Server 2003 (~XP) by default.
  After this patch it may be necessary to override the default Windows
  target version to Vista (or newer) via:
  autotools: `CPPFLAGS=-D_WIN32_WINNT=0x0600`
  cmake: `-DCURL_TARGET_WINDOWS_VERSION=0x0600`
- mingw-w64 v6+ allow changing the default at toolchain build-time.

Notes:
- For non-MSVC, non-mingw-w64 toolchains, `if_nametoindex` needs to be
  allowlisted in `curl_setup.h`, if they do support it.

Fixes #17985 (discussion)
Closes #18009
2026-01-17 11:41:49 +01:00

2.2 KiB

curl internals

The canonical libcurl internals documentation is now in the everything curl book. This file lists supported versions of libs and build tools.

Portability

We write curl and libcurl to compile with C89 compilers on 32-bit and up machines. Most of libcurl assumes more or less POSIX compliance but that is not a requirement.

We write libcurl to build and work with lots of third party tools, and we want it to remain functional and buildable with these and later versions (older versions may still work but is not what we work hard to maintain):

Dependencies

We aim to support these or later versions.

  • brotli 1.0.0 (2017-09-21)
  • c-ares 1.6.0 (2008-12-09)
  • GnuTLS 3.6.5 (2018-12-01)
  • libidn2 2.0.0 (2017-03-29)
  • LibreSSL 2.9.1 (2019-04-22)
  • libssh 0.9.0 (2019-06-28)
  • libssh2 1.9.0 (2019-06-20)
  • mbedTLS 3.2.0 (2022-07-11)
  • MIT Kerberos 1.3 (2003-07-31)
  • nghttp2 1.15.0 (2016-09-25)
  • OpenLDAP 2.0 (2000-08-01)
  • OpenSSL 3.0.0 (2021-09-07)
  • Windows Vista 6.0 (2006-11-08 - 2012-04-10)
  • wolfSSL 3.4.6 (2017-09-22)
  • zlib 1.2.5.2 (2011-12-11)
  • zstd 1.0 (2016-08-31)

Build tools

When writing code (mostly for generating stuff included in release tarballs) we use a few "build tools" and we make sure that we remain functional with these versions:

  • cmake 3.7 (2016-11-11)
  • GNU autoconf 2.59 (2003-11-06)
  • GNU automake 1.7 (2002-09-25)
  • GNU libtool 1.4.2 (2001-09-11)
  • GNU m4 1.4 (2007-09-21)
  • mingw-w64 3.0 (2013-09-20)
  • perl 5.8 (2002-07-19), on Windows: 5.22 (2015-06-01)
  • Visual Studio 2010 10.0 (2010-04-12 - 2020-07-14)

Library Symbols

All symbols used internally in libcurl must use a Curl_ prefix if they are used in more than a single file. Single-file symbols must be made static. Public ("exported") symbols must use a curl_ prefix. Public API functions are marked with CURL_EXTERN in the public header files so that all others can be hidden on platforms where this is possible.