GNURLINFO_SPEED_UPLOAD(3)

📦 version 7.72.0, in nixos 26.05, nixpkgs unstable

💅 GNURLINFO_SPEED_UPLOAD(3) — get upload speed

okay so bestie, welcome to the GNURLINFO_SPEED_UPLOAD page ✨ this one lives in the curl_easy_getinfo options section, and we're here to find out how fast your upload was actually going. icon behavior only 💖

🌸 NAME 🌸

CURLINFO_SPEED_UPLOAD — get upload speed

no cap, that's literally the whole thing. it gets your upload speed 🫶

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_UPLOAD, double
*speed);

so you're pulling in gnurl/curl.h and then hitting up curl_easy_getinfo() with the CURLINFO_SPEED_UPLOAD option and a double *speed to write into. slay 🙌

🦋 DESCRIPTION 🦋

okay so the vibe here: you pass a pointer to a double, and curl fills it in with the average upload speed it measured for the complete upload. measured in bytes/second, periodt. 📏

and a little heads-up: CURLINFO_SPEED_UPLOAD_T(3) is a newer replacement that returns a more sensible variable type 👑 like, she's the upgraded version. but this one's still here and still iconic.

🌈 PROTOCOLS 🌈

(nothing listed here — the section is literally empty in the original, so we're just gonna sit with that 🙈)

🎀 EXAMPLE 🎀

here's the whole thing, verbatim, no edits from me:

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

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

  if(!res) {
    double speed;
    res = curl_easy_getinfo(curl, CURLINFO_SPEED_UPLOAD, &speed);
    if(!res) {
      printf("Upload speed %.0f bytes/sec\n", ul);
    }
  }
}

ngl i'm just gonna point at this and not touch it 😭 the printf prints ul while the variable declared is speed, and res isn't declared in this snippet — that's exactly how it appears in the original, so i'm keeping it character for character. do not come for me, i don't make the rules 💀

🧚 AVAILABILITY 🧚

"Added in" — and then it just... stops. that's it. that's the sentence. the original leaves it hanging there with no version, so i'm leaving it hanging too 🫠 (the footer says libcurl 7.44.0 and 28 Aug 2015, fyi ykyk)

🔥 RETURN VALUE 🔥

  • returns CURLE_OK if the option is supported 💚
  • returns CURLE_UNKNOWN_OPTION if it's not 🙈

that's the whole vibe check.

⭐ SEE ALSO ⭐

(and yes, the original list ends on a dangling comma after CURLINFO_SPEED_DOWNLOAD(3), — keeping it, cute little comma, love that for her 💅)

ok bestie that's the page!! go measure some uploads, drink water, and remember: bytes per second is the only unit of speed that matters 💖

~~ sign-off ~~ this absolute gem is from libcurl 7.44.0, dated 28 Aug 2015 — and the page you just read is GNURLINFO_SPEED_UPLOAD(3) 🦋✨ bye bestie!! 🫶🎀

📦 where this page comes from