Skip to content
Browse files

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

Closes #4446
  • Loading branch information...
akashihi authored and bagder committed Oct 1, 2019
1 parent 683102e commit 0b386392d60360bd642e0f115249debea3367913
Showing with 3 additions and 2 deletions.
  1. +2 −0 docs/libcurl/curl_multi_perform.3
  2. +1 −2 docs/libcurl/libcurl-multi.3
@@ -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
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.
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,
there is no longer any transfers in progress.
@@ -97,8 +97,7 @@ period for your select() calls.
\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
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
number changes, you know when one or more transfers are done.
successful. One or more of the transfers may have failed.

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

0 comments on commit 0b38639

Please sign in to comment.
You can’t perform that action at this time.