diff options
author | Daniel Stenberg <daniel@haxx.se> | 2010-04-26 15:37:39 +0200 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2010-04-26 15:38:07 +0200 |
commit | 2c1b0624ac6ed2695e121bd9581a9eb9762a5c98 (patch) | |
tree | 4a5cdfd3438735f6993920957bb8833f88f0ae16 /docs | |
parent | 107146676e20a00074321b433baaaeb027464871 (diff) | |
download | curl-2c1b0624ac6ed2695e121bd9581a9eb9762a5c98.tar.gz |
progress callback: can be called more than once per sec
Diffstat (limited to 'docs')
-rw-r--r-- | docs/libcurl/curl_easy_setopt.3 | 10 |
1 files 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<curl/curl.h>\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 |