mirror/curl
2
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2025-02-17 14:59:45 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: add note on failed handles not being counted by curl_multi_perform

Browse Source 
Closes #4446
This commit is contained in:
Denis Chaplygin 2019-10-01 10:55:08 +03:00 committed by Daniel Stenberg
parent 683102e0a0
commit 0b386392d6
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
2 changed files with 3 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/libcurl/curl_multi_perform.3
View File

@ -46,6 +46,8 @@ know that there is one or more transfers less "running". You can then call
\fIcurl_multi_info_read(3)\fP to get information about each individual \fIcurl_multi_info_read(3)\fP to get information about each individual
completed transfer, and that returned info includes CURLcode and more. If an completed transfer, and that returned info includes CURLcode and more. If an
added handle fails very quickly, it may never be counted as a running_handle. added handle fails very quickly, it may never be counted as a running_handle.
You could use \fIcurl_multi_info_read(3)\fP to track actual status of the
added handles in that case.
When \fIrunning_handles\fP is set to zero (0) on the return of this function, When \fIrunning_handles\fP is set to zero (0) on the return of this function,
there is no longer any transfers in progress. there is no longer any transfers in progress.

3
docs/libcurl/libcurl-multi.3
View File

@ -97,8 +97,7 @@ period for your select() calls.
\fIcurl_multi_perform(3)\fP stores the number of still running transfers in \fIcurl_multi_perform(3)\fP stores the number of still running transfers in
one of its input arguments, and by reading that you can figure out when all one of its input arguments, and by reading that you can figure out when all
the transfers in the multi handles are done. 'done' does not mean the transfers in the multi handles are done. 'done' does not mean
successful. One or more of the transfers may have failed. Tracking when this successful. One or more of the transfers may have failed.
number changes, you know when one or more transfers are done.
To get information about completed transfers, to figure out success or not and To get information about completed transfers, to figure out success or not and
similar, \fIcurl_multi_info_read(3)\fP should be called. It can return a similar, \fIcurl_multi_info_read(3)\fP should be called. It can return a