CURLMINFO_XFERS_ADDED(3)

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

💅 CURLMINFO_XFERS_ADDED(3) — the curl_multi_get_offt offt constant, bestie ✨

okay so this is a page from the Library Functions Manual, and it's about CURLMINFO_XFERS_ADDED — like, the whole point is counting every single easy handle that ever got added. yes bestie, ever. 🎀

✨ NAME ✨

CURLMINFO_XFERS_ADDED — the cumulative number of all easy handles added 💖

🌸 SYNOPSIS 🌸

#include <curl/curl.h>

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

🦋 DESCRIPTION 🦋

So the vibe here is: the cumulative number of all easy handles added to the multi, ever. Not "right now", not "at the moment" — ever. It's a running total that just keeps going up like your screen time 😭.

And the way that this includes internal handles added for tasks — like resolving via DoH, for example — periodt. So those sneaky little internal ones count too, no cap. 👑

if you're actually trying to find the current number of easy handles the multi is managing right now, that is NOT this. go use CURLMINFO_XFERS_CURRENT(3) instead, bestie 🫶

💜 DEFAULT 💜

n/a

(literally nothing, it's giving "no default needed" 💀)

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols ✨ — every single one, we love an inclusive icon.

🎀 EXAMPLE 🎀

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

  curl_multi_get_offt(m, CURLMINFO_XFERS_ADDED, &value);
}

look at her go 💅

⭐ AVAILABILITY ⭐

Added in curl 8.16.0 — so if you're on something older, she is not there yet, sorry 🥲

🔥 RETURN VALUE 🔥

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

CURLM_OK (0) means everything was OK 😌. Non-zero means an error occurred — go check libcurl-errors(3) for the tea 🍓.

🌸 SEE ALSO 🌸

and that's the whole page, bestie 💖 this iconic little number came to you from libcurl, dated 2026-10-25, and it's filed under CURLMINFO_XFERS_ADDED(3) — mwah, mwah, go count some handles 🧚✨

📦 where this page comes from