curl_easy_perform(3)

curl_easy_perform(3)     libcurl Manual      curl_easy_perform(3)

NAME

     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(3)  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.

     You can do any amount of calls to curl_easy_perform(3) 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 connection for the following
     transfers, thus  making  the  operations  faster,  less  CPU
     intense and using less network resources. Just note that you
     will have to use curl_easy_setopt(3) 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  parallel
     transfers, you must use several curl handles.

RETURN VALUE

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

SEE ALSO

     curl_easy_init(3), curl_easy_setopt(3),

libcurl 7.7          Last change: 5 Mar 2001                    1