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

curl_multi_fdset.3: improved the formatting slightly

Browse Source
This commit is contained in:
Daniel Stenberg
2014-10-09 13:41:13 +02:00
parent 93b268ade0
commit 51f6702fe1
1 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/libcurl/curl_multi_fdset.3
View File

@@ -53,18 +53,18 @@ of type fd_set that on return specifies the file descriptors to be checked for
error conditions pending. error conditions pending.
If no file descriptors are set by libcurl, \fImax_fd\fP will contain -1 when If no file descriptors are set by libcurl, \fImax_fd\fP will contain -1 when
this function returns. Otherwise it will contain the higher descriptor number this function returns. Otherwise it will contain the highest descriptor number
libcurl set. When libcurl returns -1 in \fImax_fd\fP, it is because libcurl libcurl set. When libcurl returns -1 in \fImax_fd\fP, it is because libcurl
currently does something that isn't possible for your application to monitor currently does something that isn't possible for your application to monitor
with a socket and unfortunately you can then not know exactly when the current with a socket and unfortunately you can then not know exactly when the current
action is completed using select(). When max_fd returns with -1, you need to action is completed using select(). You then need to wait a while before you
wait a while and then proceed and call \fIcurl_multi_perform\fP anyway. How proceed and call \fIcurl_multi_perform(3)\fP anyway. How long to wait? We
long to wait? We suggest 100 milliseconds at least, but you may want to test suggest 100 milliseconds at least, but you may want to test it out in your own
it out in your own particular conditions to find a suitable value. particular conditions to find a suitable value.
When doing select(), you should use \fBcurl_multi_timeout\fP to figure out how When doing select(), you should use \fBcurl_multi_timeout\fP to figure out how
long to wait for action. Call \fIcurl_multi_perform\fP even if no activity has long to wait for action. Call \fIcurl_multi_perform(3)\fP even if no activity
been seen on the fd_sets after the timeout expires as otherwise internal has been seen on the fd_sets after the timeout expires as otherwise internal
retries and timeouts may not work as you'd think and want. retries and timeouts may not work as you'd think and want.
If one of the sockets used by libcurl happens to be larger than what can be If one of the sockets used by libcurl happens to be larger than what can be