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

FreeBSD Manual Pages

  
 
  

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

NAME
     CURLINFO_SIZE_DELIVERED - number of delivered bytes

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_DELIVERED,
				curl_off_t *dlp);

DESCRIPTION
     Pass  a  pointer  to a curl_off_t to receive the total amount of bytes that
     were passed on to the write callback in the download. The	amount	is  only
     for  the  latest  transfer and gets reset again for each new transfer. This
     counts actual payload data, what's also commonly called body. All meta  and
     header data is excluded from this amount (unless CURLOPT_HEADER(3) is set).

     The   delivered   size   may   differ   from   the   size	 retrieved  with
     CURLINFO_SIZE_DOWNLOAD_T(3) when CURLOPT_ACCEPT_ENCODING(3) is used for au-
     tomatic data decompression, as this is then the size  of  the  uncompressed
     body while CURLINFO_SIZE_DOWNLOAD_T(3) returns the size of the download.

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 */
	   curl_off_t dl;
	   result = curl_easy_getinfo(curl, CURLINFO_SIZE_DELIVERED, &dl);
	   if(result == CURLE_OK) {
	     printf("Stored %" CURL_FORMAT_CURL_OFF_T " bytes\n", dl);
	   }
	 }
       }
     }

AVAILABILITY
     Added in curl 8.20.0

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_CONTENT_LENGTH_DOWNLOAD_T(3),   CURLINFO_SIZE_DOWNLOAD_T(3),  CUR-
     LOPT_MAXFILESIZE(3), curl_easy_getinfo(3), curl_easy_setopt(3)

libcurl 			   2026-06-11	      CURLINFO_SIZE_DELIVERED(3)

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

home | help