Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_SIZE_DOWNLOAD(3)   Library Functions Manual   CURLINFO_SIZE_DOWNLOAD(3)

NAME
     CURLINFO_SIZE_DOWNLOAD - number of downloaded bytes

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_DOWNLOAD, double *dlp);

DESCRIPTION
     Pass  a  pointer to a double to receive the total amount of bytes that were
     downloaded. The amount is only for the latest transfer and gets reset again
     for each new transfer. This counts actual payload data,  what's  also  com-
     monly called body. All meta and header data is excluded and not included in
     this number.

     CURLINFO_SIZE_DOWNLOAD_T(3) is a newer replacement that returns a more sen-
     sible variable type.

PROTOCOLS
     This functionality affects all supported protocols

EXAMPLE
     int main(void)
     {
       CURL *curl = curl_easy_init();
       if(curl) {
	 CURLcode result;
	 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

	 /* Perform the request */
	 result = curl_easy_perform(curl);

	 if(result == CURLE_OK) {
	   /* check the size */
	   double dl;
	   result = curl_easy_getinfo(curl, CURLINFO_SIZE_DOWNLOAD, &dl);
	   if(result == CURLE_OK) {
	     printf("Downloaded %.0f bytes\n", dl);
	   }
	 }
       }
     }

DEPRECATED
     Deprecated since 7.55.0.

AVAILABILITY
     Added in curl 7.4.1

RETURN VALUE
     curl_easy_setopt(3) returns a CURLcode indicating success or error.

     CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     libcurl-errors(3).

SEE ALSO
     CURLINFO_SIZE_DOWNLOAD_T(3),   CURLINFO_SIZE_UPLOAD_T(3),	CURLOPT_MAXFILE-
     SIZE(3), curl_easy_getinfo(3), curl_easy_setopt(3)

libcurl 			   2026-06-11	       CURLINFO_SIZE_DOWNLOAD(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLINFO_SIZE_DOWNLOAD&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help