CURLOPT_SSH_HOSTKEYFUNCTION.md: for new connections only

curl can then reuse the connection for subsequent transfers without
calling this function again.

Fixes #21606
Reported-by: Joshua Rogers
Closes #21628
This commit is contained in:
Daniel Stenberg 2026-05-15 13:54:41 +02:00
parent 066478f634
commit 60cd4815fd
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2

View file

@ -38,12 +38,15 @@ shown above. It overrides CURLOPT_SSH_KNOWNHOSTS(3).
This callback gets called when the verification of the SSH host key is needed.
**key** is **keylen** bytes long and is the key to check. **keytype**
says what type it is, from the **CURLKHTYPE_*** series in the
**curl_khtype** enum.
**key** is **keylen** bytes long and is the key to check. **keytype** says
what type it is, from the **CURLKHTYPE_*** series in the **curl_khtype** enum.
**clientp** is a custom pointer set with CURLOPT_SSH_HOSTKEYDATA(3).
This option is used to verify new SSH connections only. Once the connection
has been vetted by this callback it is deemed vetted and may be reused again
without invoking this callback again.
The callback must return one of the following return codes to tell libcurl how
to act: