curl/docs
Stefan Eissing 92db819714
cf-dns: pass peer for result lookups
The DNS filter knows the peer it resolves and the code parts that want
the results know the peer as well. Pass it to lookup methods to make
sure results match.

Background: when tunneling, the resolved peer is not always the one that
other filters are looking for. Especially when HTTPS-RR results are
accessed in TLS filters, those will differ.

This prevents a HTTPS-RR for a proxy to be used for the origin when ECH
is activated. To make ECH work through a tunnel, we need to start an
additional resolve. Something to be fixed after 8.21.

Closes #22042
2026-06-16 23:15:43 +02:00
..
cmdline-opts _URL.md: remove the zone-id mention 2026-06-16 16:21:22 +02:00
examples perl: || die -> or die 2026-06-16 00:41:29 +02:00
internals lib: transfer origin and proxy handling 2026-06-12 23:52:00 +02:00
libcurl curl_formdata: fix to pass long where missing, document CURLFORM_NAMELENGTH 2026-06-15 16:57:21 +02:00
tests tidy-up: miscellaneous 2026-06-09 11:07:55 +02:00
.gitignore
ALTSVC.md
BINDINGS.md tidy-up: miscellaneous 2026-06-05 16:57:38 +02:00
BUG-BOUNTY.md
BUGS.md
CIPHERS-TLS12.md
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
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
CURL-DISABLE.md
CURLDOWN.md tidy-up: sort TLS backends, distros, alphabetically 2026-05-11 11:57:25 +02:00
DEPRECATE.md
DISTROS.md
EARLY-RELEASE.md
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: miscellaneous 2026-06-05 16:57:38 +02:00
FEATURES.md
GOVERNANCE.md
HELP-US.md
HISTORY.md tidy-up: miscellaneous 2026-05-20 00:50:43 +02:00
HSTS.md
HTTP-COOKIES.md
HTTP3.md tidy-up: git options, ECH, HTTP/3 documentation 2026-04-25 13:59:20 +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 build: say Quiche support is experimental, where missing 2026-06-01 22:33:57 +02:00
INSTALL.md tidy-up: sort TLS backends, distros, alphabetically 2026-05-11 11:57:25 +02:00
INTERNALS.md tidy-up: miscellaneous 2026-06-14 20:10:28 +02:00
IPFS.md
KNOWN_BUGS.md cf-dns: pass peer for result lookups 2026-06-16 23:15:43 +02:00
KNOWN_RISKS.md
MAIL-ETIQUETTE.md
Makefile.am creds: hold credentials 2026-05-12 16:05:15 +02:00
MANUAL.md docs: tidy-up scheme references 2026-05-19 16:55:45 +02:00
mk-ca-bundle.md
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
ROADMAP.md
runtests.md
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
SSL-PROBLEMS.md
SSLCERTS.md SSLCERTS: document 8.19.0 default Native CA builds (Windows) 2026-05-16 11:55:59 +02:00
testcurl.md
THANKS scripts: catch Credits-to contributors 2026-05-17 22:48:22 +02:00
THANKS-filter tidy-up: miscellaneous 2026-05-16 01:56:17 +02:00
TheArtOfHttpScripting.md
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 verify-release: verify more thoroughly with git 2026-06-15 15:44:08 +02:00
VERSIONS.md tidy-up: miscellaneous 2026-04-30 20:22:23 +02:00
VULN-DISCLOSURE-POLICY.md VULN-DISCLOSURE-POLICY: non-released code 2026-06-15 14:32:35 +02:00
wcurl.md

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.