curl-curl/docs
Viktor Szakats 49ef2f8d1e
cmake: adjust defaults for target platforms not supporting shared libs
If CMake reports the target platform not supporting shared libs, turn
`BUILD_SHARED_LIBS` off by default. CMake 3.30+ fails with an error
when trying to create a `SHARED` target for such platforms. Earlier
versions used a workaround that may or may not have worked in practice.

Ref: https://cmake.org/cmake/help/v3.30/policy/CMP0164.html

Seen this with a build setting `-DCMAKE_SYSTEM_NAME=Generic`, e.g.
AmigaOS.

Note this may introduce incompatibility for "Generic" targets, which
support shared libs. If that's the case, set `BUILD_SHARED_LIBS=ON`
manually.

Also drop AmigaOS-specific logic handled automatically after this patch.

Ref: https://cmake.org/cmake/help/v3.7/command/get_property.html
Ref: https://cmake.org/cmake/help/v3.7/prop_gbl/TARGET_SUPPORTS_SHARED_LIBS.html

Closes #19420
2025-11-09 17:56:20 +01:00
..
cmdline-opts docs: mention umask need when curl creates files 2025-11-07 14:12:59 +01:00
examples examples: consistent variable naming across examples 2025-10-31 16:44:57 +01:00
internals scorecard: add perf support on linux 2025-10-14 16:24:35 +02:00
libcurl CURLOPT_SSH_KEYFUNCTION.md: fix minor indent mistake in example 2025-11-08 17:49:30 +01:00
tests tests: replace remaining CR bytes with the new macro %CR 2025-11-06 20:45:45 +01:00
.gitignore
ALTSVC.md
BINDINGS.md BINDINGS: change dead link to archive.org version 2025-11-04 09:07:41 +01:00
BUG-BOUNTY.md tidy-up: URLs 2025-09-23 00:34:46 +02:00
BUGS.md docs: fix two typos 2025-07-01 22:53:04 +02:00
CIPHERS-TLS12.md
CIPHERS.md tidy-up: update MS links, allow long URLs via checksrc 2025-09-20 11:49:23 +02:00
CMakeLists.txt tests: move test docs into /docs 2025-05-28 15:00:03 +02:00
CODE_OF_CONDUCT.md
CODE_REVIEW.md docs: fix broken link in CODE_REVIEW.md 2025-06-21 10:32:06 +02:00
CONTRIBUTE.md docs/CONTRIBUTE: fix broken link 2025-06-30 13:47:06 +02:00
curl-config.md
CURL-DISABLE.md
CURLDOWN.md misc: fix typos 2025-07-12 08:59:44 +02:00
DEPRECATE.md DEPRECATE.md: remove OpenSSL 1.1.1 support already in December 2025 2025-10-03 08:14:23 +02:00
DISTROS.md DISTROS.md: add Haiku 2025-07-18 00:54:34 +02:00
EARLY-RELEASE.md
ECH.md ECH.md: make OpenSSL branch clone instructions work 2025-10-26 01:19:12 +02:00
EXPERIMENTAL.md
FAQ docs: point two broken links to archive.org 2025-08-25 19:43:03 +02:00
FEATURES.md
GOVERNANCE.md
HELP-US.md
HISTORY.md HISTORY: extend 2025-11-04 16:25:28 +01:00
HSTS.md
HTTP3.md HTTP3: clarify the status for "old" OpenSSL, not current 2025-10-20 09:07:12 +02:00
HTTP-COOKIES.md tidy-up: URLs 2025-09-23 00:34:46 +02:00
HTTPSRR.md tidy-up: URLs 2025-09-23 00:34:46 +02:00
INFRASTRUCTURE.md docs: fix two typos 2025-07-01 22:53:04 +02:00
INSTALL
INSTALL-CMAKE.md cmake: adjust defaults for target platforms not supporting shared libs 2025-11-09 17:56:20 +01:00
INSTALL.md INSTALL.md: add another OS (Azure Sphere) 2025-10-20 10:32:08 +02:00
INTERNALS.md kerberos: bump minimum to 1.3 (2003-07-08), drop legacy logic 2025-10-10 19:47:08 +02:00
IPFS.md
KNOWN_BUGS KNOWN_BUGS: SOCKS-SSPI discards the security context 2025-10-17 17:45:06 +02:00
MAIL-ETIQUETTE.md
Makefile.am dist: do not distribute CI.md 2025-09-15 11:15:31 +02:00
MANUAL.md
mk-ca-bundle.md
options-in-versions tool_getparam: add --knownhosts 2025-10-06 13:41:22 +02:00
README.md
RELEASE-PROCEDURE.md RELEASE-PROCEDURE.md: drop the _newslog edit mention 2025-09-08 11:12:47 +02:00
ROADMAP.md
runtests.md tests: replace remaining CR bytes with the new macro %CR 2025-11-06 20:45:45 +01:00
RUSTLS.md tidy-up: URLs 2025-09-23 00:34:46 +02:00
SECURITY-ADVISORY.md
SPONSORS.md
SSL-PROBLEMS.md spelling: 'a' vs 'an' 2025-05-30 11:38:35 +02:00
SSLCERTS.md ssl: support Apple SecTrust configurations 2025-10-03 12:02:23 +02:00
testcurl.md scripts: fix to quote the copyright email address 2025-07-12 08:59:44 +02:00
THANKS THANKS: add contributors from 8.17.0 2025-11-05 07:57:28 +01:00
THANKS-filter RELEASE-NOTES: synced 2025-11-05 14:12:23 +01:00
TheArtOfHttpScripting.md
TODO TODO: improve code for large MQTT payloads 2025-11-09 11:53:39 +01:00
URL-SYNTAX.md URL-SYNTAX.md: drop link to codepoints.net to pass linkcheck 2025-08-12 10:26:21 +02:00
VERSIONS.md VERSIONS: 8.18.0 is now pending 2025-11-05 08:00:05 +01:00
VULN-DISCLOSURE-POLICY.md VULN-DISCLOSURE-POLICY: make it pass test 1275 2025-09-07 12:39:44 +02:00
wcurl.md wcurl: import v2025.11.04 2025-11-04 14:15:46 +01:00

curl logo

Documentation

You find a mix of various documentation in this directory and subdirectories, using several different formats. Some of them are not ideal for reading directly in your browser.

If you would rather see the rendered version of the documentation, check out the curl website's documentation section for general curl stuff or the libcurl section for libcurl related documentation.