CURLOPT_SSL_CTX_FUNCTION.md: expand on effects connection reuse

Closes #21164
This commit is contained in:
Daniel Stenberg 2026-03-30 23:11:38 +02:00
parent 8e89646a3d
commit 2f93a0e6bb
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -70,6 +70,13 @@ anything about it, which then subsequently can lead to libcurl unknowingly
reusing SSL connections with different properties. To remedy this you may set
CURLOPT_FORBID_REUSE(3) from the callback function.
A connection that is set up with this callback can be put in the connection
pool by libcurl and then reused in following transfers without the callback
being called. The connection may even be selected from the pool to be used for
transfers not using this callback. If the callback should only be valid for
the specific transfer the callback verifies, it should be marked unsuitable
for reuse with CURLOPT_FORBID_REUSE(3).
If you are using DNS-over-HTTPS (DoH) via CURLOPT_DOH_URL(3) then this
callback is also called for those transfers and the curl handle is set to an
internal handle. **This behavior is subject to change.** We recommend setting