curl_easy_perform - Perform a file transfer

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_perform(CURL *handle);

DESCRIPTION

       This  function  is  called  after  the  init  and  all the
       curl_easy_setopt() calls are made, and  will  perform  the
       transfer  as  described in the options.  It must be called
       with the same handle as input as the  curl_easy_init  call
       returned.

       libcurl  version  7.7  or  later  (for  older versions see
       below): You can do any amount of calls  to  curl_easy_per-
       form()  while  using  the  same  handle.  If you intend to
       transfer more than one file, you are even encouraged to do
       so.  libcurl  will then attempt to re-use the same connec-
       tion for the following transfers, thus making  the  opera-
       tions  faster,  less  CPU  intense  and using less network
       resources.  Just  note  that  you   will   have   to   use
       curl_easy_setopt  between  the  invokes to set options for
       the following curl_easy_perform.

       You must never call this function simultaneously from  two
       places  using  the  same  handle.  Let the function return
       first before invoking it another time. If you want  paral-
       lel transfers, you must use several curl handles.

       Before  libcurl  version 7.7: You are only allowed to call
       this function once using the same handle. If you  want  to
       do  repeated  calls,  you  must call curl_easy_cleanup and
       curl_easy_init again first.

RETURN VALUE

       0  means  everything  was  ok,  non-zero  means  an  error
       occurred  as  <curl/curl.h> defines. If the CURLOPT_ERROR-
       BUFFER was set with curl_easy_setopt there will be a read-
       able  error  message  in the error buffer when non-zero is
       returned.

SEE ALSO

       curl_easy_init(3), curl_easy_setopt(3),

BUGS

       Surely there are some, you tell me!