← Back to branch summary

~ubuntu-branches/ubuntu/lucid/curl/lucid-201010031940

« back to all changes in this revision

Viewing changes to docs/libcurl/curl_multi_setopt.3

  • Committer: Bazaar Package Importer
  • Author(s): Michael Vogt
  • Date: 2009-04-29 11:10:29 UTC
  • mfrom: (3.2.3 sid)
  • Revision ID: james.westby@ubuntu.com-20090429111029-2j5eiyokfw2bw049
Tags: 7.19.4-1ubuntu1
* Merge from debian unstable, remaining changes:
  - Drop build dependencies: stunnel, libdb4.6-dev, libssh2-1-dev
  - Add build-dependency on openssh-server
  - Drop libssh2-1-dev from libcurl4-openssl-dev's Depends.
  - Call automake-1.9 with --add-missing --copy --force
* drop debian/patches/security_CVE-2009-0037.patch 
  - this patch is part of 7.19.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/libcurl/curl_multi_setopt.3
1
 
.\" $Id: curl_multi_setopt.3,v 1.7 2007-12-11 21:19:38 bagder Exp $
 
1
.\" $Id: curl_multi_setopt.3,v 1.9 2008-12-28 21:56:56 bagder Exp $
2
2
.\"
3
3
.TH curl_multi_setopt 3 "10 Oct 2006" "libcurl 7.16.0" "libcurl Manual"
4
4
.SH NAME
21
21
.IP CURLMOPT_SOCKETFUNCTION
22
22
Pass a pointer to a function matching the \fBcurl_socket_callback\fP
23
23
prototype. The \fIcurl_multi_socket(3)\fP functions inform the application
24
 
about updates in the socket (file descriptor) status by doing none, one or
 
24
about updates in the socket (file descriptor) status by doing none, one, or
25
25
multiple calls to the curl_socket_callback given in the \fBparam\fP
26
26
argument. They update the status with changes since the previous time a
27
27
\fIcurl_multi_socket(3)\fP function was called. If the given callback pointer
38
38
handle will make it attempt to perform HTTP Pipelining as far as possible for
39
39
transfers using this handle. This means that if you add a second request that
40
40
can use an already existing connection, the second request will be \&"piped"
41
 
on the same connection rather than being executed in parallell. (Added in
 
41
on the same connection rather than being executed in parallel. (Added in
42
42
7.16.0)
43
43
.IP CURLMOPT_TIMERFUNCTION
44
44
Pass a pointer to a function matching the \fBcurl_multi_timer_callback\fP
49
49
\fIcurl_multi_perform(3)\fP) - to allow libcurl to keep timeouts and retries
50
50
etc to work. A timeout value of -1 means that there is no timeout at all, and
51
51
0 means that the timeout is already reached. Libcurl attempts to limit calling
52
 
this only when the fixed future timeout time actually change. See also
 
52
this only when the fixed future timeout time actually changes. See also
53
53
\fICURLMOPT_TIMERDATA\fP. This callback can be used instead of, or in addition
54
54
to, \fIcurl_multi_timeout(3)\fP. (Added in 7.16.0)
55
55
.IP CURLMOPT_TIMERDATA
63
63
libcurl will enlarge the size for each added easy handle to make it fit 4
64
64
times the number of added easy handles.
65
65
 
66
 
By setting this option, you can prevent the cache size to grow beyond the
 
66
By setting this option, you can prevent the cache size from growing beyond the
67
67
limit set by you.
68
68
 
69
69
When the cache is full, curl closes the oldest one in the cache to prevent the
70
 
number of open connections to increase.
 
70
number of open connections from increasing.
71
71
 
72
72
This option is for the multi handle's use only, when using the easy interface
73
73
you should instead use the \fICURLOPT_MAXCONNECTS\fP option.