From 4e878eae7956fccadb9dc62a5cac65f663c26223 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Mon, 5 Mar 2001 15:51:34 +0000 Subject: updated to libcurl 7.7 conditions --- docs/curl_easy_perform.3 | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) (limited to 'docs/curl_easy_perform.3') diff --git a/docs/curl_easy_perform.3 b/docs/curl_easy_perform.3 index f892fd3fe..e1ff0188a 100644 --- a/docs/curl_easy_perform.3 +++ b/docs/curl_easy_perform.3 @@ -2,11 +2,11 @@ .\" nroff -man [file] .\" Written by daniel@haxx.se .\" -.TH curl_easy_perform 3 "1 Mar 2001" "Curl 7.0" "libcurl Manual" +.TH curl_easy_perform 3 "5 Mar 2001" "libcurl 7.7" "libcurl Manual" .SH NAME -curl_easy_perform - Do the actual transfer in a "easy" session +curl_easy_perform - Perform a file transfer .SH SYNOPSIS -.B #include +.B #include .sp .BI "CURLcode curl_easy_perform(CURL *" handle "); .ad @@ -17,9 +17,22 @@ It must be called with the same .I handle as input as the curl_easy_init call returned. -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. +libcurl version 7.7 or later (for older versions see below): You can do any +amount of calls to curl_easy_perform() 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 +.I 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 parallel 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. .SH RETURN VALUE 0 means everything was ok, non-zero means an error occurred as .I -- cgit v1.2.3