CURLMINFO_XFERS_RUNNING(3)

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

💅 CURLMINFO_XFERS_RUNNING(3) 💅

okay so bestie, this is a page from the Library Functions Manual, and it's about a little constant called CURLMINFO_XFERS_RUNNING — yes that's a whole mouthful, we're gonna get through it together 🫶

✨ NAME ✨

CURLMINFO_XFERS_RUNNING — literally just the number of easy handles that are running right now, no cap 👑

🌈 SYNOPSIS 🌈

#include <curl/curl.h>

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

like, that's the whole vibe. you pass in your multi handle, you pass in the info constant, and you hand over a curl_off_t *pvalue so it can drop the answer in for you 💖

🦋 DESCRIPTION 🦋

so CURLMINFO_XFERS_RUNNING is the count of easy handles that are currently running — and by that we mean the ones where the transfer has started but is not finished yet. it's giving "in progress, don't @ me" energy 😭✨

🎀 DEFAULT 🎀

n/a — there's genuinely no default here, bestie. it's not that kind of party 🙈

🧚 PROTOCOLS 🧚

this functionality affects all supported protocols. every single one. all of them. periodt 💅

🌸 EXAMPLE 🌸

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

  curl_multi_get_offt(m, CURLMINFO_XFERS_RUNNING, &value);
}

look at her go 🥹 init the multi handle, make a curl_off_t value, then ask for the running count and it lands right in &value. iconic behaviour, no notes.

⭐ AVAILABILITY ⭐

added in curl 8.16.0 — so if you're on something older, she is not there yet, sorry bestie 😭

💀 RETURN VALUE 💀

curl_multi_get_offt(3) returns a CURLMcode — that's your little "did it work or did it flop" indicator 🫶

  • CURLM_OK (0) means everything was OK ✨
  • non-zero means an error occurred 😬 and you should go check out libcurl-errors(3) for what went wrong

👑 SEE ALSO 👑

go read those too, they're her sisters fr fr 💜

and that's the whole page babes 🌈 — brought to you by libcurl, dated 2026-10-25, filed under CURLMINFO_XFERS_RUNNING(3). mwah 💋🎀

📦 where this page comes from