← Back to branch summary

~vorlon/ubuntu/natty/curl/multiarch

« back to all changes in this revision

Viewing changes to docs/libcurl/curl_multi_fdset.3

  • Committer: Bazaar Package Importer
  • Author(s): Bhavani Shankar
  • Date: 2010-06-20 13:56:28 UTC
  • mfrom: (3.4.7 sid)
  • Revision ID: james.westby@ubuntu.com-20100620135628-e30tp9jldq6hq985
Tags: 7.21.0-1ubuntu1
https://launchpad.net/bugs/596334
* Merge from debian unstable.  Remaining changes: LP: #596334
  - Keep build deps in main:
    - Drop build dependencies: stunnel, libssh2-1-dev
    - Add build-dependency on openssh-server
    - Drop libssh2-1-dev from libcurl4-openssl-dev's Depends.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/libcurl/curl_multi_fdset.3
1
 
.\" $Id: curl_multi_fdset.3,v 1.13 2008-12-28 21:56:56 bagder Exp $
2
1
.\"
3
2
.TH curl_multi_fdset 3 "2 Jan 2006" "libcurl 7.16.0" "libcurl Manual"
4
3
.SH NAME
21
20
otherwise remove any others. The \fIcurl_multi_perform(3)\fP function should be
22
21
called as soon as one of them is ready to be read from or written to.
23
22
 
 
23
To be sure to have up-to-date results, you should call
 
24
\fIcurl_multi_perform\fP until it does not return CURLM_CALL_MULTI_PERFORM
 
25
prior to calling \fIcurl_multi_fdset\fP.  This will make sure that libcurl has
 
26
updated the handles' socket states.
 
27
 
24
28
If no file descriptors are set by libcurl, \fImax_fd\fP will contain -1 when
25
29
this function returns. Otherwise it will contain the higher descriptor number
26
30
libcurl set.
27
31
 
28
 
You should also be aware that when doing select(), you should consider using a
29
 
rather small (single-digit number of seconds) timeout and call
30
 
\fIcurl_multi_perform\fP regularly - even if no activity has been seen on the
31
 
fd_sets - as otherwise libcurl-internal retries and timeouts may not work as
32
 
you'd think and want.
33
 
 
34
 
Starting with libcurl 7.16.0, you should use \fBcurl_multi_timeout\fP to
35
 
figure out how long to wait for action.
 
32
When doing select(), you should use \fBcurl_multi_timeout\fP to figure out how
 
33
long to wait for action. Call \fIcurl_multi_perform\fP even if no activity has
 
34
been seen on the fd_sets after the timeout expires as otherwise internal
 
35
retries and timeouts may not work as you'd think and want.
36
36
.SH RETURN VALUE
37
37
CURLMcode type, general libcurl multi interface error code. See
38
38
\fIlibcurl-errors(3)\fP
39
39
.SH "SEE ALSO"
40
 
.BR curl_multi_cleanup "(3)," curl_multi_init "(3), "
41
 
.BR curl_multi_timeout "(3) "
 
40
.BR curl_multi_cleanup "(3), " curl_multi_init "(3), "
 
41
.BR curl_multi_timeout "(3), " curl_multi_perform "(3) "