CURLMOPT_SOCKETFUNCTION.md: add advice for socket callback invocation times

Explain when a registered socket callback may get invoked to make user
better aware on how to handle it.

Closes #16441
This commit is contained in:
Stefan Eissing 2025-02-23 10:05:41 +01:00 committed by Daniel Stenberg
parent e1b3d46944
commit 51f8aa79a9
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -47,6 +47,11 @@ libcurl then expects the application to monitor the sockets for the specific
activities and tell libcurl again when something happens on one of them. Tell activities and tell libcurl again when something happens on one of them. Tell
libcurl by calling curl_multi_socket_action(3). libcurl by calling curl_multi_socket_action(3).
This callback may get invoked at any time when interacting with libcurl.
This may even happen after all transfers are done and is *likely* to
happen *during* a call to curl_multi_cleanup(3) when cached connections
are shut down.
# CALLBACK ARGUMENTS # CALLBACK ARGUMENTS
*easy* identifies the specific transfer for which this update is related. *easy* identifies the specific transfer for which this update is related.