← Back to branch summary

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

« back to all changes in this revision

Viewing changes to docs/libcurl/libcurl-multi.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:
docs/libcurl/libcurl-multi.3
5
5
.\" *                            | (__| |_| |  _ <| |___
6
6
.\" *                             \___|\___/|_| \_\_____|
7
7
.\" *
8
 
.\" * Copyright (C) 1998 - 2006, Daniel Stenberg, <daniel@haxx.se>, et al.
 
8
.\" * Copyright (C) 1998 - 2007, Daniel Stenberg, <daniel@haxx.se>, et al.
9
9
.\" *
10
10
.\" * This software is licensed as described in the file COPYING, which
11
11
.\" * you should have received as part of this distribution. The terms
18
18
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19
19
.\" * KIND, either express or implied.
20
20
.\" *
21
 
.\" * $Id: libcurl-multi.3,v 1.13 2006-06-26 06:43:45 bagder Exp $
 
21
.\" * $Id: libcurl-multi.3,v 1.15 2007-02-10 12:07:46 bagder Exp $
22
22
.\" **************************************************************************
23
23
.\"
24
 
.TH libcurl-multi 3 "13 Oct 2001" "libcurl 7.10.1" "libcurl multi interface"
 
24
.TH libcurl-multi 3 "3 Feb 2007" "libcurl 7.16.0" "libcurl multi interface"
25
25
.SH NAME
26
26
libcurl-multi \- how to use the multi interface
27
27
.SH DESCRIPTION
112
112
If you want to re-use an easy handle that was added to the multi handle for
113
113
transfer, you must first remove it from the multi stack and then re-add it
114
114
again (possibly after having altered some options at your own choice).
 
115
.SH "MULTI_SOCKET"
 
116
Since 7.16.0, the \fIcurl_multi_socket(3)\fP function offers a way for
 
117
applications to not only avoid being forced to use select(), but it also
 
118
offers a much more high-performing API that will make a significant difference
 
119
for applications using large numbers of simultaneous connections.
 
120
 
 
121
\fIcurl_multi_socket(3)\fP (and \fIcurl_multi_socket_all(3)\fP) is then used
 
122
instead of \fIcurl_multi_perform(3)\fP.
 
123
.SH "BLOCKING"
 
124
A few areas in the code are still using blocking code, even when used from the
 
125
multi interface. While we certainly want and intend for these to get fixed in
 
126
the future, you should be aware of the following current restrictions:
 
127
 
 
128
 - Name resolves on non-windows unless c-ares is used
 
129
 - GnuTLS SSL connections
 
130
 - Active FTP connections
 
131
 - HTTP proxy CONNECT operations
 
132
 - SCP and SFTP connections
 
133
 - SFTP transfers
 
134
 - file:// transfers