CURLMINFO_XFERS_DONE(3)

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

💅 CURLMINFO_XFERS_DONE(3) 💅

ok so real talk, bestie — this page lives in the Library Functions Manual section, and it's all about CURLMINFO_XFERS_DONE. say it with me one time. iconic. periodt.

✨ NAME ✨

CURLMINFO_XFERS_DONE — the number of finished-but-not-yet-processed easy handles 🎀

✨ SYNOPSIS ✨

#include <curl/curl.h>

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

✨ DESCRIPTION ✨

okay so. this is the count of easy handles that are currently finished but have not yet been processed via curl_multi_info_read(3). like they're done done, results sitting there, just nobody's come to pick them up yet. the way that queue just waits 😭💅

✨ DEFAULT ✨

n/a — literally nothing, there's no default, bestie, it's a read 🫶

✨ PROTOCOLS ✨

this functionality affects all supported protocols. all of them. every single one. 🌈👑

✨ EXAMPLE ✨

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

  curl_multi_get_offt(m, CURLMINFO_XFERS_DONE, &value);
}

short, sweet, ate and left no crumbs 💖

✨ AVAILABILITY ✨

added in curl 8.16.0 ⭐ (so if you're on something older, vibe check your version first 🦋)

✨ RETURN VALUE ✨

curl_multi_get_offt(3) returns a CURLMcode — that's the "did it work tho" code.

CURLM_OK (0) means everything was OK 🎀. anything non-zero means an error occurred 😭 — go see libcurl-errors(3) for the tea. iykyk.

✨ SEE ALSO ✨

ngl, those two above are the sibling icons of this page — go read them too, bestie, don't leave them on read 🙈

ok that's the whole page, you're so welcome 💜 — this masterpiece is brought to you by libcurl, dated 2026-10-25, and it's called CURLMINFO_XFERS_DONE(3) in case you forgot already, mwah 🌸🧚‍♀️

📦 where this page comes from