From 2c1b0624ac6ed2695e121bd9581a9eb9762a5c98 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Mon, 26 Apr 2010 15:37:39 +0200 Subject: progress callback: can be called more than once per sec --- docs/libcurl/curl_easy_setopt.3 | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index 243180d00..88b216c3d 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -246,11 +246,11 @@ argument in the opensocket callback set with \fICURLOPT_OPENSOCKETFUNCTION\fP. Function pointer that should match the \fIcurl_progress_callback\fP prototype found in \fI\fP. This function gets called by libcurl instead of its internal equivalent with a frequent interval during operation (roughly -once per second) no matter if data is being transfered or not. Unknown/unused -argument values passed to the callback will be set to zero (like if you only -download data, the upload size will remain 0). Returning a non-zero value from -this callback will cause libcurl to abort the transfer and return -\fICURLE_ABORTED_BY_CALLBACK\fP. +once per second or sooner) no matter if data is being transfered or not. +Unknown/unused argument values passed to the callback will be set to zero +(like if you only download data, the upload size will remain 0). Returning a +non-zero value from this callback will cause libcurl to abort the transfer and +return \fICURLE_ABORTED_BY_CALLBACK\fP. If you transfer data with the multi interface, this function will not be called during periods of idleness unless you call the appropriate libcurl -- cgit v1.2.3