CURLOPT_LOW_SPEED_TIME(3)

💅 CURLOPT_LOW_SPEED_TIME(3) 💅

okay so bestie, this is a page from the Library Functions Manual and honestly? it's giving "the vibes are too slow, we're leaving" energy. buckle up 🎀

---

✨ NAME ✨

CURLOPT_LOW_SPEED_TIME — the low speed limit time period, aka "how long do we tolerate this snail situation before we bail" 🐌⏱️

---

🌸 SYNOPSIS 🌸

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOW_SPEED_TIME,
                          long speedtime);

---

🦋 DESCRIPTION 🦋

so you pass a long as the parameter, right? and it holds the time in number seconds that the transfer speed should be below the CURLOPT_LOW_SPEED_LIMIT(3) — like, below it the whole time — for the library to consider it "too slow" and just abort. periodt. 💀

literally it's the patience timer. the "you have this many seconds to stop being slow" timer. no cap. 🔥

---

🎀 DEFAULT 🎀

0, which means disabled — so by default there's no patience limit and the vibe check never fails 🙈

---

🌈 PROTOCOLS 🌈

this functionality affects all supported protocols — every single one, no exceptions, we love an inclusive icon 👑

---

⭐ EXAMPLE ⭐

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    /* abort if slower than 30 bytes/sec during 60 seconds */
    curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 60L);
    curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 30L);
    result = curl_easy_perform(curl);
    if(CURLE_OPERATION_TIMEDOUT == result) {
      printf("Timeout.\n");
    }
    /* always cleanup */
    curl_easy_cleanup(curl);
  }
}

see how the comment says it all — abort if slower than 30 bytes/sec during 60 seconds — that's the whole plot bestie 🍓

---

💜 AVAILABILITY 💜

added in curl 7.1 — an oldie but a goodie, she's been here since forever and she ate 🫶

---

🌸 RETURN VALUE 🌸

curl_easy_setopt(3) returns a CURLcode indicating success or error — like a little mood ring for your function call 💅

• CURLE_OK (0) means everything was OK ✨
• anything non-zero means an error occurred 😭 — go check libcurl-errors(3) for the tea

---

👑 SEE ALSO 👑

• CURLOPT_LOW_SPEED_LIMIT(3)
• CURLOPT_TIMEOUT(3)

the rest of the squad, fr fr 🧚

---

and that's the page!! brought to you by libcurl, dated 2026-10-12, from the one and only CURLOPT_LOW_SPEED_TIME(3) manual page — mwah 💖✨