CURLOPT_NOPROGRESS(3)

✨ CURLOPT_NOPROGRESS(3) ✨

okay so this is a page from the Library Functions Manual, and honestly bestie, it's a little one but it's lowkey iconic — it's the switch that turns the whole progress meter off. 💅

---

🎀 NAME 🎀

CURLOPT_NOPROGRESS — switch off the progress meter

🦋 SYNOPSIS 🦋

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOPROGRESS, long onoff);

💖 DESCRIPTION 💖

So, if onoff is to 1, it tells the library to shut off the progress meter completely for requests done with this handle. Like, gone. No little spinning bar, no percentages, nothing. 🙈

And not only that — it also prevents CURLOPT_XFERINFOFUNCTION(3) or CURLOPT_PROGRESSFUNCTION(3) from getting called at all. So if you set this thing, don't be surprised when your callback is just sitting there, never being invited to the party. 😭

🍓 DEFAULT 🍓

1, meaning it normally runs without a progress meter. yep, quiet by default, main character energy who doesn't need to announce herself. ✨

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols — every single one, no cap. 👑

🧚 EXAMPLE 🧚

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

    /* enable progress meter */
    curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 0L);

    /* Perform the request */
    curl_easy_perform(curl);
  }
}

see how it's set to 0L there? that's the "no wait, actually do show me the progress meter" move. ate. 💅

⭐ AVAILABILITY ⭐

Added in curl 7.1 — yeah she's been around a minute, a true veteran of the game. 🫶

🔥 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). Not me hoping you never see the non-zero one 😭

🌸 SEE ALSO 🌸

• CURLOPT_DEBUGFUNCTION(3)
• CURLOPT_PROGRESSFUNCTION(3)
• CURLOPT_VERBOSE(3)
• CURLOPT_XFERINFOFUNCTION(3)

---

ok go read those too bestie, iykyk — they're all in the same friend group 🫶

kisses, this was libcurl, dated 2026-10-12 — mwah 💋