generic-library/curl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

users should use the CURLMOPT_TIMERFUNCTION rather than curl_multi_timeout

Browse Source 
when using the socket API
This commit is contained in:
Daniel Stenberg
2007-07-30 22:01:04 +00:00
parent ba5c71b79b
commit 16710a1c9b
1 changed files with 12 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/libcurl/curl_multi_socket.3
View File

@@ -106,7 +106,7 @@ The \fIuserp\fP argument is a private pointer you have previously set with
CURLMcode type, general libcurl multi interface error code. CURLMcode type, general libcurl multi interface error code.
If you receive \fICURLM_CALL_MULTI_PERFORM\fP, this basically means that you If you receive \fICURLM_CALL_MULTI_PERFORM\fP, this basically means that you
should call \fIcurl_multi_perform\fP again, before you wait for more actions should call \fIcurl_multi_socket(3)\fP again, before you wait for more actions
on libcurl's sockets. You don't have to do it immediately, but the return code on libcurl's sockets. You don't have to do it immediately, but the return code
means that libcurl may have more data available to return or that there may be means that libcurl may have more data available to return or that there may be
more data to send off before it is "satisfied". more data to send off before it is "satisfied".
@@ -119,22 +119,25 @@ function returns OK.
2. Set the socket callback with CURLMOPT_SOCKETFUNCTION 2. Set the socket callback with CURLMOPT_SOCKETFUNCTION
3. Add easy handles 3. Set the timeout callback with CURLMOPT_TIMERFUNCTION, to get to know what
timeout value to use when waiting for socket activities.
4. Call curl_multi_socket_all() first once 4. Add easy handles
5. Provide some means to manage the sockets libcurl is using, so you can check 5. Call curl_multi_socket_all() first once
6. Provide some means to manage the sockets libcurl is using, so you can check
them for activity. This can be done through your application code, or by way them for activity. This can be done through your application code, or by way
of an external library such as libevent or glib. of an external library such as libevent or glib.
6. Use curl_multi_timeout() to figure out how long to wait for activity 7. Wait for activity on any of libcurl's sockets, use the timeout value your
calback has been told
7. Wait for activity on any of libcurl's sockets
8, When activity is detected, call curl_multi_socket_action() for the 8, When activity is detected, call curl_multi_socket_action() for the
socket(s) that got action. socket(s) that got action. If no activity is detected and the timeout expires,
call \fIcurl_multi_socket(3)\fP with \fICURL_SOCKET_TIMEOUT\fP
9. Go back to step 6. 9. Go back to step 7.
.SH AVAILABILITY .SH AVAILABILITY
This function was added in libcurl 7.15.4, although deemed stable since This function was added in libcurl 7.15.4, although deemed stable since
7.16.0. 7.16.0.