CURLMINFO_XFERS_PENDING(3)

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

💅 CURLMINFO_XFERS_PENDING(3) 💅

okay so bestie, welcome to the libcurl corner of the manual pages — this one's from the Library Functions Manual and it's all about counting the little easy handles that are out here waiting their turn 🎀

✨ NAME ✨

CURLMINFO_XFERS_PENDING — the number of easy handles just vibing in the waiting room, not started yet 🪑

🌸 SYNOPSIS 🌸

#include <curl/curl.h>

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

like, that's the whole entrance exam bestie 📝

🦋 DESCRIPTION 🦋

So CURLMINFO_XFERS_PENDING is literally the number of current easy handles waiting to start. That's it, that's the tea ☕

And ngl, a transfer you just added might go pending for a whole bunch of reasons — no cap:

  • a connection limit forces it to wait 😤 like the bouncer said "not tonight"
  • resolving DNS isn't finished yet — still looking up the address 🔍
  • it's not clear yet whether an existing, matching connection may allow multiplexing (HTTP/2 or HTTP/3) 👀 like maybe there's room in the group chat, maybe not

🍓 DEFAULT 🍓

n/a

(yeah. nothing. it's giving no default energy 💀)

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols — every single one, periodt 👑

🧚 EXAMPLE 🧚

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

  curl_multi_get_offt(m, CURLMINFO_XFERS_PENDING, &value);
}

look at her go 😭 so simple, so iconic ✨

⭐ AVAILABILITY ⭐

Added in curl 8.16.0 — so if you're on anything older, bestie, it's not gonna be there 🙈

💜 RETURN VALUE 💜

curl_multi_get_offt(3) returns a CURLMcode indicating success or error — that's the vibe check of the whole call ✅

  • CURLM_OK (0) means everything was OK — we ate 💅
  • non-zero means an error occurred 😭 see libcurl-errors(3) for the full breakdown

🔥 SEE ALSO 🔥

go read those too, iykyk 🫶

okay that's the whole page bestie — brought to you by libcurl, dated 2026-10-25, and yes this is the CURLMINFO_XFERS_PENDING(3) girlies' official documentation 💖 mwah, go forth and count those pending transfers 🌸✨

📦 where this page comes from