diff options
Diffstat (limited to 'docs/libcurl/opts/CURLOPT_PROGRESSFUNCTION.3')
-rw-r--r-- | docs/libcurl/opts/CURLOPT_PROGRESSFUNCTION.3 | 119 |
1 files changed, 0 insertions, 119 deletions
diff --git a/docs/libcurl/opts/CURLOPT_PROGRESSFUNCTION.3 b/docs/libcurl/opts/CURLOPT_PROGRESSFUNCTION.3 deleted file mode 100644 index 809cf387d..000000000 --- a/docs/libcurl/opts/CURLOPT_PROGRESSFUNCTION.3 +++ /dev/null @@ -1,119 +0,0 @@ -.\" ************************************************************************** -.\" * _ _ ____ _ -.\" * Project ___| | | | _ \| | -.\" * / __| | | | |_) | | -.\" * | (__| |_| | _ <| |___ -.\" * \___|\___/|_| \_\_____| -.\" * -.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. -.\" * -.\" * This software is licensed as described in the file COPYING, which -.\" * you should have received as part of this distribution. The terms -.\" * are also available at https://curl.se/docs/copyright.html. -.\" * -.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell -.\" * copies of the Software, and permit persons to whom the Software is -.\" * furnished to do so, under the terms of the COPYING file. -.\" * -.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY -.\" * KIND, either express or implied. -.\" * -.\" * SPDX-License-Identifier: curl -.\" * -.\" ************************************************************************** -.\" -.TH CURLOPT_PROGRESSFUNCTION 3 "17 Jun 2014" libcurl libcurl -.SH NAME -CURLOPT_PROGRESSFUNCTION \- progress meter callback -.SH SYNOPSIS -.nf -#include <curl/curl.h> - -int progress_callback(void *clientp, - double dltotal, - double dlnow, - double ultotal, - double ulnow); - -CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROGRESSFUNCTION, - progress_callback); -.fi -.SH DESCRIPTION -Pass a pointer to your callback function, which should match the prototype -shown above. - -This option is deprecated and we encourage users to use the -newer \fICURLOPT_XFERINFOFUNCTION(3)\fP instead, if you can. - -This function gets called by libcurl instead of its internal equivalent with a -frequent interval. While data is being transferred it is invoked frequently, -and during slow periods like when nothing is being transferred it can slow -down to about one call per second. - -\fIclientp\fP is the pointer set with \fICURLOPT_PROGRESSDATA(3)\fP, it is not -used by libcurl but is only passed along from the application to the callback. - -The callback gets told how much data libcurl is about to transfer and has -transferred, in number of bytes. \fIdltotal\fP is the total number of bytes -libcurl expects to download in this transfer. \fIdlnow\fP is the number of -bytes downloaded so far. \fIultotal\fP is the total number of bytes libcurl -expects to upload in this transfer. \fIulnow\fP is the number of bytes -uploaded so far. - -Unknown/unused argument values passed to the callback are be set to zero (like -if you only download data, the upload size remains 0). Many times the callback -is called one or more times first, before it knows the data sizes so a program -must be made to handle that. - -If your callback function returns CURL_PROGRESSFUNC_CONTINUE it causes libcurl -to continue executing the default progress function. - -Returning any other non-zero value from this callback makes libcurl abort the -transfer and return \fICURLE_ABORTED_BY_CALLBACK\fP. - -If you transfer data with the multi interface, this function is not called -during periods of idleness unless you call the appropriate libcurl function -that performs transfers. - -\fICURLOPT_NOPROGRESS(3)\fP must be set to 0 to make this function actually -get called. -.SH DEFAULT -By default, libcurl has an internal progress meter. That is rarely wanted by -users. -.SH PROTOCOLS -All -.SH EXAMPLE -.nf - struct progress { - char *private; - size_t size; - }; - - static size_t progress_callback(void *clientp, - double dltotal, - double dlnow, - double ultotal, - double ulnow) - { - struct progress *memory = (struct progress *)clientp; - - /* use the values */ - - return 0; /* all is good */ - } - - struct progress data; - - /* pass struct to callback */ - curl_easy_setopt(curl_handle, CURLOPT_PROGRESSDATA, &data); - - curl_easy_setopt(curl_handle, CURLOPT_PROGRESSFUNCTION, progress_callback); -.fi -.SH AVAILABILITY -Deprecated since 7.32.0. -.SH RETURN VALUE -Returns CURLE_OK. -.SH "SEE ALSO" -.BR CURLOPT_VERBOSE (3), -.BR CURLOPT_NOPROGRESS (3), -.BR CURLOPT_XFERINFOFUNCTION (3) |