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 per-form perform
form 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 func-tion function
tion return first before invoking it another time. If you want parallel transfers, you must use sev-eral several
eral curl handles.
RETURN VALUE
0 means everything was ok, non-zero means an error occurred as <curl/curl.h> defines. If the CUR-LOPT_ERRORBUFFER CURLOPT_ERRORBUFFER
LOPT_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)
|