curl/docs
Daniel Stenberg a6af50c484
multi: forbid curl_easy_pause from within multi socket callback
- there is a risk for a nasty recursive situation

- we avoid certain risks that the pause call changes things so that when
  returning from the callback, the state of some internals is undefined
  and we need to reload which is easy to miss

- we can't think of legitiate use cases for doing this. This is
  basically just the new favorite point for AI and security researchers
  to find hypothetical problems

Closes #22179
2026-06-26 13:43:48 +02:00
..
cmdline-opts tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
examples tool_operate: remove call to abort() 2026-06-26 13:41:55 +02:00
internals tool_operate: remove call to abort() 2026-06-26 13:41:55 +02:00
libcurl multi: forbid curl_easy_pause from within multi socket callback 2026-06-26 13:43:48 +02:00
tests tidy-up: miscellaneous 2026-06-09 11:07:55 +02:00
.gitignore
ALTSVC.md docs: fold long lines 2025-12-11 11:42:28 +01:00
BINDINGS.md tidy-up: miscellaneous 2026-06-05 16:57:38 +02:00
BUG-BOUNTY.md BUG-BOUNTY.md: minor rephrase to say there is no bug bounty 2026-03-10 17:34:08 +01:00
BUGS.md docs: avoid using the word 'magic' 2026-03-03 15:32:13 +01:00
CIPHERS-TLS12.md docs: update CIPHERS.md 2024-08-12 23:35:56 +02:00
CIPHERS.md tidy-up: miscellaneous 2026-05-27 16:53:57 +02:00
CMakeLists.txt build: stop building and installing runtests.1 and testcurl.1 2026-04-28 09:07:27 +02:00
CODE_OF_CONDUCT.md tidy-up: Markdown, clang-format nits 2026-01-22 23:44:47 +01:00
CODE_REVIEW.md tidy-up: miscellaneous 2026-06-09 11:07:55 +02:00
CONTRIBUTE.md tidy-up: miscellaneous 2026-05-27 16:53:57 +02:00
curl-config.md docs: minor edits to please the new spellchecker regime 2025-02-27 13:15:21 +01:00
CURL-DISABLE.md lib: make SMB support opt-in 2026-03-22 11:55:39 +01:00
CURLDOWN.md tidy-up: sort TLS backends, distros, alphabetically 2026-05-11 11:57:25 +02:00
DEPRECATE.md DEPRECATE.md: fix copy-and-paste mistaken subtitles 2026-03-26 11:06:25 +01:00
DISTROS.md docs: add LibreELEC to DISTROS.md 2026-01-26 12:12:05 -08:00
EARLY-RELEASE.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
ECH.md tidy-up: sort TLS backends, distros, alphabetically 2026-05-11 11:57:25 +02:00
EXPERIMENTAL.md build: say Quiche support is experimental, where missing 2026-06-01 22:33:57 +02:00
FAQ.md tidy-up: make 'CA' uppercase, where missing 2026-06-22 21:04:45 +02:00
FEATURES.md tidy-up: miscellaneous 2026-01-20 12:37:56 +01:00
GOVERNANCE.md docs: avoid starting sentences with However, 2026-03-07 23:49:11 +01:00
HELP-US.md tidy-up: miscellaneous 2026-01-15 13:06:13 +01:00
HISTORY.md tidy-up: miscellaneous 2026-05-20 00:50:43 +02:00
HSTS.md hsts: accept 10K entries in the list 2026-04-02 10:22:35 +02:00
HTTP-COOKIES.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
HTTP3.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
HTTPSRR.md docs: tidy-up scheme references 2026-05-19 16:55:45 +02:00
INFRASTRUCTURE.md docs: tidy-up scheme references 2026-05-19 16:55:45 +02:00
INSTALL
INSTALL-CMAKE.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
INSTALL.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
INTERNALS.md INTERNALS.md: document minimum nghttp3 and ngtcp2 versions 2026-06-17 14:37:54 +02:00
IPFS.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
KNOWN_BUGS.md KNOWN_BUGS.md: drop outdated CMake issues 2026-06-19 18:25:54 +02:00
KNOWN_RISKS.md progress: count amount of data "delivered" to application 2026-03-21 23:21:55 +01:00
MAIL-ETIQUETTE.md badwords: avoid 'simply' 2026-03-10 19:34:06 +01:00
Makefile.am creds: hold credentials 2026-05-12 16:05:15 +02:00
MANUAL.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
mk-ca-bundle.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
options-in-versions HTTP/3: add proxy CONNECT and MASQUE CONNECT-UDP support (ngtcp2 QUIC) 2026-05-27 08:49:53 +02:00
README.md
RELEASE-PROCEDURE.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
ROADMAP.md
runtests.md runtests: drop orphaned, no-op -k option 2026-06-19 14:46:49 +02:00
RUSTLS.md tidy-up: miscellaneous 2026-05-27 16:53:57 +02:00
SECURITY-ADVISORY.md SECURITY-ADVISORY.md: expand 2026-06-11 10:09:06 +02:00
SPONSORS.md BUG-BOUNTY.md: we stop the bug-bounty end of Jan 2026 2026-01-26 08:26:28 +01:00
SSL-PROBLEMS.md tidy-up: Markdown, clang-format nits 2026-01-22 23:44:47 +01:00
SSLCERTS.md SSLCERTS: document 8.19.0 default Native CA builds (Windows) 2026-05-16 11:55:59 +02:00
testcurl.md tidy-up: Markdown, clang-format nits 2026-01-22 23:44:47 +01:00
THANKS THANKS: added names from 8.21.0 release 2026-06-24 07:52:50 +02:00
THANKS-filter tidy-up: miscellaneous 2026-05-16 01:56:17 +02:00
TheArtOfHttpScripting.md tidy-up: make 'CA' uppercase, where missing 2026-06-22 21:04:45 +02:00
TODO.md docs: tidy-up scheme references 2026-05-19 16:55:45 +02:00
URL-SYNTAX.md URL-SYNTAX: document more URL parsing details 2026-06-02 11:13:50 +02:00
VERIFY.md docs/VERIFY: expand with more things we do 2026-06-18 12:55:22 +02:00
VERSIONS.md VERSIONS: 8.21.0 release 2026-06-24 07:52:50 +02:00
VULN-DISCLOSURE-POLICY.md VULN-DISCLOSURE-POLICY: non-released code 2026-06-15 14:32:35 +02:00
wcurl.md spacecheck: check long lines and repeat spaces, fix fallouts 2026-03-25 11:02:08 +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.