← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/curl/gutsy-updates

« 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-08-01 12:22:30 UTC
  • mfrom: (1.1.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20070801122230-uaarmp6lo65py9t6
Tags: 7.16.4-1ubuntu1
* Merge with Debian.
  - Drop debian/patches/gnutls-verifications, applied upstream.
  - Remove all stuff which should be reverted according to 7.16.2-6ubuntu4.
  - Remaining change: drop stunnel build dependency.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/libcurl/libcurl-multi.3
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.15 2007-02-10 12:07:46 bagder Exp $
 
21
.\" * $Id: libcurl-multi.3,v 1.18 2007-05-26 20:50:00 bagder Exp $
22
22
.\" **************************************************************************
23
23
.\"
24
24
.TH libcurl-multi 3 "3 Feb 2007" "libcurl 7.16.0" "libcurl multi interface"
104
104
receive there includes an easy handle pointer which you may use to identify
105
105
which easy handle the information regards.
106
106
 
 
107
When a single transfer is completed, the easy handle is still left added to
 
108
the multi stack. You need to first remove the easy handle with
 
109
\fIcurl_multi_remove_handle(3)\fP and then close it with
 
110
\fIcurl_easy_cleanup(3)\fP, or possibly set new options to it and add it again
 
111
with \fIcurl_multi_add_handle(3)\fP to start another transfer.
 
112
 
107
113
When all transfers in the multi stack are done, cleanup the multi handle with
108
114
\fIcurl_multi_cleanup(3)\fP. Be careful and please note that you \fBMUST\fP
109
115
invoke separate \fIcurl_easy_cleanup(3)\fP calls on every single easy handle
125
131
multi interface. While we certainly want and intend for these to get fixed in
126
132
the future, you should be aware of the following current restrictions:
127
133
 
 
134
.nf
128
135
 - Name resolves on non-windows unless c-ares is used
129
136
 - GnuTLS SSL connections
130
137
 - Active FTP connections
131
138
 - HTTP proxy CONNECT operations
132
139
 - SCP and SFTP connections
133
140
 - SFTP transfers
 
141
 - TFTP transfers
134
142
 - file:// transfers
 
143
.fi