INTERNALS.md (1846B)
1 <!-- 2 Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 4 SPDX-License-Identifier: curl 5 --> 6 7 # curl internals 8 9 The canonical libcurl internals documentation is now in the [everything 10 curl](https://everything.curl.dev/internals) book. This file lists supported 11 versions of libs and build tools. 12 13 ## Portability 14 15 We write curl and libcurl to compile with C89 compilers on 32-bit and up 16 machines. Most of libcurl assumes more or less POSIX compliance but that is 17 not a requirement. 18 19 We write libcurl to build and work with lots of third party tools, and we 20 want it to remain functional and buildable with these and later versions 21 (older versions may still work but is not what we work hard to maintain): 22 23 ## Dependencies 24 25 We aim to support these or later versions. 26 27 - OpenSSL 1.0.2a 28 - LibreSSL 2.9.1 29 - GnuTLS 3.1.10 30 - zlib 1.2.5.2 31 - libssh2 1.2.8 32 - c-ares 1.6.0 33 - libssh 0.9.0 34 - libidn2 2.0.0 35 - wolfSSL 3.4.6 36 - OpenLDAP 2.0 37 - MIT Kerberos 1.2.4 38 - Heimdal ? 39 - nghttp2 1.15.0 40 - Winsock 2.2 (on Windows 95+ and Windows CE .NET 4.1+) 41 42 ## Build tools 43 44 When writing code (mostly for generating stuff included in release tarballs) 45 we use a few "build tools" and we make sure that we remain functional with 46 these versions: 47 48 - GNU Libtool 1.4.2 49 - GNU Autoconf 2.59 50 - GNU Automake 1.7 51 - GNU M4 1.4 52 - perl 5.8 53 - roffit 0.5 54 - cmake 3.7 55 56 Library Symbols 57 =============== 58 59 All symbols used internally in libcurl must use a `Curl_` prefix if they are 60 used in more than a single file. Single-file symbols must be made static. 61 Public ("exported") symbols must use a `curl_` prefix. Public API functions 62 are marked with `CURL_EXTERN` in the public header files so that all others 63 can be hidden on platforms where this is possible.