curl_multi_get_offt(3)

📦
version 8.23.0 · 11 versions
, in alpine 3.23, alpine 3.24

🎀 curl_multi_get_offt(3) — the multi-handle tea-spiller ✨

okay hi bestie 🫶 so this is a libcurl manpage, and honestly it's short and sweet — the whole vibe is "imma peek inside your multi handle and tell you a number." no cap, that's it. let's get into it 💅

✨ NAME ✨

curl_multi_get_offt — extract information from a multi handle 🔍

🌸 SYNOPSIS 🌸

#include <curl/curl.h>

CURLMcode curl_multi_get_offt(CURLM *multi_handle,
                              CURLMinfo_offt info,
                              curl_off_t *pvalue);

🦋 DESCRIPTION 🦋

Get the info kept in the multi handle 💖. Like, you hand it a multi_handle, you tell it which info you're curious about, and it drops the answer into pvalue.

but listen 👀 — if the info is not applicable, this function returns CURLM_UNKNOWN_OPTION. so if you get that back, it's not a skill issue on your end, that info just doesn't apply here 😭

👑 OPTIONS 👑

the following information can be extracted ✨ (this is the menu, bestie — pick one):

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols — every single one, no gatekeeping 🙌

🍓 EXAMPLE 🍓

int main(void)
{
  /* init a multi stack */
  CURLM *multi = curl_multi_init();
  CURL *curl = curl_easy_init();
  curl_off_t n;

  if(curl) {
    /* add the transfer */
    curl_multi_add_handle(multi, curl);

    curl_multi_get_offt(multi, CURLMINFO_XFERS_ADDED, &n);
    /* on successful add, n is 1 */
  }
}

see how clean that is?? n comes back as 1 on a successful add, like slay 🎀

⭐ AVAILABILITY ⭐

Added in curl 8.16.0 — so if you're on something older, this icon is simply not available to you yet, my condolences 💀

💜 RETURN VALUE 💜

This function returns a CURLMcode indicating success or error ✨

CURLM_OK (0) means everything was OK 🥳 — non-zero means an error occurred, see libcurl-errors(3) for the whole lore 🙈

🧚 SEE ALSO 🧚

bestie reminder 💅: CURLM_UNKNOWN_OPTION is a real answer, not a bug. if the info isn't applicable, that's just what you get, fr fr 🫶

k that's the whole page!! mwah 💖 this lil cutie is from libcurl, dated 2026-10-25 — go forth and get your offt values, you absolute main character 👑✨

📦 where this page comes from