GNURLINFO_...D_UPLOAD_T(3)

📦 version 7.72.0, in nixos 26.05, nixpkgs unstable

💅 NAME 💅

CURLINFO_SPEED_UPLOAD_T — bestie, this one gets you the upload speed 🚀

okay so real talk: this is a curl_easy_getinfo option, and the manual page lives in the gnurl neck of the woods (iykyk) ✨

🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_UPLOAD_T,
curl_off_t *speed);

🦋 DESCRIPTION 🦋

So the way this works: you pass a pointer to a curl_off_t, and curl fills it in with the average upload speed it measured for the complete upload 💖

Units? bytes/second. That's it, that's the whole vibe. Measured in bytes/second, periodt 📏

🎀 PROTOCOLS 🎀

ngl this section is literally empty on the page — no protocols listed here 🙈 so we're not gonna sit here and make any up, that's not the move 💅

✨ EXAMPLE ✨

okay here's the whole thing, copy it exactly, no cap:

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) {
    curl_off_t speed;
    res = curl_easy_getinfo(curl, CURLINFO_SPEED_UPLOAD_T, &speed);
    if(!res) {
      printf("Upload speed %" CURL_FORMAT_CURL_OFF_T " bytes/sec\n", speed);
    }
  }
}

the way that printf eats with CURL_FORMAT_CURL_OFF_T — iconic formatting behaviour, we love a portable format macro 🫶

⭐ AVAILABILITY ⭐

Added in 7.55.0 🎀 (so if you're on something ancient, that's your sign to update, bestie)

🌈 RETURN VALUE 🌈

  • CURLE_OK — slay, the option is supported 💖
  • CURLE_UNKNOWN_OPTION — not supported, and it will absolutely tell you 😭

🔥 SEE ALSO 🔥

(and yes, the trailing comma is literally in the original, we keep it exactly, that's the rule 👑)

and that's the whole page, bestie 🧚 source is libcurl 7.55.0, dated 25 May 2017 — the manual page header is GNURLINFO_...D_UPLOAD_T(3), section 3, curl_easy_getinfo options 💜 bye ily, go measure some uploads 🍓

📦 where this page comes from