4
<!-- Manpage converted by man2html 3.0.1 -->
8
curl_easy_perform - Perform a file transfer
12
<H2>SYNOPSIS</H2><PRE>
13
<B>#include</B> <B><curl/curl.h></B>
15
<B>CURLcode</B> <B>curl_easy_perform(CURL</B> <B>*</B><I>handle</I><B>);</B>
19
<H2>DESCRIPTION</H2><PRE>
20
This function is called after the init and all the
21
curl_easy_setopt() calls are made, and will perform the
22
transfer as described in the options. It must be called
23
with the same <I>handle</I> as input as the curl_easy_init call
26
libcurl version 7.7 or later (for older versions see below):
27
You can do any amount of calls to curl_easy_perform() while
28
using the same handle. If you intend to transfer more than
29
one file, you are even encouraged to do so. libcurl will
30
then attempt to re-use the same connection for the following
31
transfers, thus making the operations faster, less CPU
32
intense and using less network resources. Just note that you
33
will have to use <I>curl</I><B>_</B><I>easy</I><B>_</B><I>setopt</I> between the invokes to set
34
options for the following curl_easy_perform.
36
You must never call this function simultaneously from two
37
places using the same handle. Let the function return first
38
before invoking it another time. If you want parallel trans�
39
fers, you must use several curl handles.
41
Before libcurl version 7.7: You are only allowed to call
42
this function once using the same handle. If you want to do
43
repeated calls, you must call curl_easy_cleanup and
44
curl_easy_init again first.
48
<H2>RETURN VALUE</H2><PRE>
49
0 means everything was ok, non-zero means an error occurred
50
as <I><curl/curl.h></I> defines. If the CURLOPT_ERRORBUFFER was set
51
with <I>curl</I><B>_</B><I>easy</I><B>_</B><I>setopt</I> there will be a readable error message
52
in the error buffer when non-zero is returned.
56
<H2>SEE ALSO</H2><PRE>
57
<B>curl_easy_init(3)</B>, <B>curl_easy_setopt(3)</B>,
62
Surely there are some, you tell me!
72
Man(1) output converted with
73
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>