~ubuntu-branches/ubuntu/lucid/curl/lucid-201101212007

« back to all changes in this revision

Viewing changes to docs/libcurl/curl_multi_perform.3

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2007-05-16 15:16:54 UTC
  • mto: (3.1.1 lenny) (1.2.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 12.
  • Revision ID: james.westby@ubuntu.com-20070516151654-x9nkigtr2j0i8d0v
Tags: upstream-7.16.2
ImportĀ upstreamĀ versionĀ 7.16.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" $Id: curl_multi_perform.3,v 1.7 2006/01/02 23:32:36 bagder Exp $
 
1
.\" $Id: curl_multi_perform.3,v 1.8 2006-09-21 11:09:54 bagder Exp $
2
2
.\"
3
3
.TH curl_multi_perform 3 "1 March 2002" "libcurl 7.9.5" "libcurl Manual"
4
4
.SH NAME
30
30
should call \fIcurl_multi_perform\fP again, before you select() on more
31
31
actions. You don't have to do it immediately, but the return code means that
32
32
libcurl may have more data available to return or that there may be more data
33
 
to send off before it is "satisfied".
 
33
to send off before it is "satisfied". Do note that \fIcurl_multi_perform(3)\fP
 
34
will return \fICURLM_CALL_MULTI_PERFORM\fP only when it wants to be called
 
35
again \fBimmediately\fP. When things are fine and there are nothing immediate
 
36
it wants done, it'll return \fICURLM_OK\fP and you need to wait for \&"action"
 
37
and then call this function again.
34
38
 
35
39
NOTE that this only returns errors etc regarding the whole multi stack. There
36
40
might still have occurred problems on individual transfers even when this
37
 
function returns OK.
 
41
function returns \fICURLM_OK\fP.
38
42
.SH "TYPICAL USAGE"
39
43
Most applications will use \fIcurl_multi_fdset(3)\fP to get the multi_handle's
40
44
file descriptors, then it'll wait for action on them using \fBselect(3)\fP and
42
46
called.
43
47
.SH "SEE ALSO"
44
48
.BR curl_multi_cleanup "(3), " curl_multi_init "(3), "
45
 
.BR curl_multi_fdset "(3), " curl_multi_info_read "(3)"
 
49
.BR curl_multi_fdset "(3), " curl_multi_info_read "(3), "
 
50
.BR libcurl-errors "(3)"