curl_easy_perform

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			  5 Mar 2001		 curl_easy_perform(3)