CURLINFO_SIZE_DOWNLOAD_T(3)

✨ CURLINFO_SIZE_DOWNLOAD_T(3) ✨

okay bestie, welcome to the Library Functions Manual 💖 this one's a lil curl page about counting your bytes, and honestly? it's giving "small but mighty." 🦋

---

🌸 NAME 🌸

CURLINFO_SIZE_DOWNLOAD_T — number of downloaded bytes 💅

---

🎀 SYNOPSIS 🎀

#include <curl/curl.h>

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

---

✨ DESCRIPTION ✨

so basically, you pass a pointer to a curl_off_t — that's where the answer lands 🫶 — and it receives the total amount of bytes that were downloaded.

couple things to know, no cap:

• the amount is only for the latest transfer, and it 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 🙈

like, it's the meat of the download, not the packaging. periodt. 👑

---

🌈 PROTOCOLS 🌈

this functionality affects all supported protocols — every single one, bestie, no favorites 💀✨

---

🧚 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) {
      /* check the size */
      curl_off_t dl;
      result = curl_easy_getinfo(curl, CURLINFO_SIZE_DOWNLOAD_T, &dl);
      if(!result) {
        printf("Downloaded %" CURL_FORMAT_CURL_OFF_T " bytes\n", dl);
      }
    }
  }
}

look at that little printf go 😭💖 iconic behavior, honestly.

---

⭐ AVAILABILITY ⭐

added in curl 7.55.0 — a classic, we stan a veteran 🎀

---

👑 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) for the whole vibe check.

---

🦋 SEE ALSO 🦋

• CURLINFO_SIZE_DOWNLOAD(3)
• CURLINFO_SIZE_UPLOAD_T(3)
• CURLOPT_MAXFILESIZE(3)
• curl_easy_getinfo(3)
• curl_easy_setopt(3)

---

ngl, go read those too. iykyk 💅

mwah 💋 bye bestie, go count those bytes — this page is from libcurl, dated 2026-10-12, and it's the CURLINFO_SIZE_DOWNLOAD_T(3) entry, slay 💖✨