mirror of
https://github.com/curl/curl.git
synced 2025-01-18 14:04:30 +08:00
e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
79 lines
1.4 KiB
Markdown
79 lines
1.4 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_PROGRESSDATA
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLOPT_PROGRESSFUNCTION (3)
|
|
- CURLOPT_XFERINFOFUNCTION (3)
|
|
Protocol:
|
|
- All
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_PROGRESSDATA - pointer passed to the progress callback
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROGRESSDATA, void *pointer);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Pass a *pointer* that is untouched by libcurl and passed as the first
|
|
argument in the progress callback set with CURLOPT_PROGRESSFUNCTION(3).
|
|
|
|
# DEFAULT
|
|
|
|
The default value of this parameter is NULL.
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
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 = clientp;
|
|
printf("private: %p\n", memory->private);
|
|
|
|
/* use the values */
|
|
|
|
return 0; /* all is good */
|
|
}
|
|
|
|
int main(void)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
struct progress data;
|
|
|
|
/* pass struct to callback */
|
|
curl_easy_setopt(curl, CURLOPT_PROGRESSDATA, &data);
|
|
curl_easy_setopt(curl, CURLOPT_PROGRESSFUNCTION, progress_callback);
|
|
|
|
curl_easy_perform(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Always
|
|
|
|
# RETURN VALUE
|
|
|
|
Returns CURLE_OK
|