CURLMINFO_XFERS_CURRENT(3)

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

💅 CURLMINFO_XFERS_CURRENT(3) 💅

okay so real quick bestie — this is a page from the Library Functions Manual, and it's all about CURLMINFO_XFERS_CURRENT, aka "how many easy handles are currently chillin' in my multi handle". let's get into it 🫶

✨ NAME ✨

CURLMINFO_XFERS_CURRENT — the number of easy handles that are currently added, fr fr

🦋 SYNOPSIS 🦋

#include <curl/curl.h>

CURLMcode curl_multi_get_offt(CURLM *handle, CURLMINFO_XFERS_CURRENT,
                              curl_off_t *pvalue);

🌸 DESCRIPTION 🌸

So this one returns the number of easy handles that are currently added to the multi handle. Like, right now. Present tense. main character energy ✨

  • It does not count handles that have already been removed — those are gone, bestie, we don't talk about them 💀
  • It does count internal handles that get added for tasks (like resolving via DoH, for example). yes, the behind-the-scenes ones count too 👑

If you want the total number of easy handles ever added to the multi, that's a different vibe entirely — go check CURLMINFO_XFERS_ADDED(3) 🎀

🍓 DEFAULT 🍓

n/a

like, there's literally nothing to default to here 🙈

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols. every single one. no cap 💅

⭐ EXAMPLE ⭐

int main(void)
{
  CURLM *m = curl_multi_init();
  curl_off_t value;

  curl_multi_get_offt(m, CURLMINFO_XFERS_CURRENT, &value);
}

look at that. iconic. not a single wasted line 🔥

🧚 AVAILABILITY 🧚

Added in curl 8.16.0 — so if you're on anything older, she's not there yet, sorry bestie 😭

💜 RETURN VALUE 💜

curl_multi_get_offt(3) returns a CURLMcode indicating success or error.

  • CURLM_OK (0) means everything was OK — slay 🎉
  • non-zero means an error occurred — and you can go look it up in libcurl-errors(3) to find out what went wrong 🔍

👑 SEE ALSO 👑

go read those too, they're the sibling pages and they also ate 💖

mwah, that's the whole page 🫶 this lil doc is brought to you by libcurl, dated 2026-10-25 — stay hydrated, close your file descriptors, and remember: internal handles count too ✨

📦 where this page comes from