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
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
*easy* identifies the specific transfer for which this update is related.