CURLMINFO_XFERS_PENDING(3) Library Functions Manual
NAME
CURLMINFO_XFERS_PENDING - Number of easy handles waiting to start
SYNOPSIS
#include <curl/curl.h>
CURLMcode curl_multi_get_offt(CURLM *handle, CURLMINFO_XFERS_PENDING,
curl_off_t *pvalue);
DESCRIPTION
The number of current easy handles waiting to start. An added transfer
might become pending for various reasons: a connection limit forces it
to wait, resolving DNS is not finished or it is not clear if an
existing, matching connection may allow multiplexing (HTTP/2 or
HTTP/3).
DEFAULT
n/a
PROTOCOLS
This functionality affects all supported protocols
EXAMPLE
int main(void)
{
CURLM *m = curl_multi_init();
curl_off_t value;
curl_multi_get_offt(m, CURLMINFO_XFERS_PENDING, &value);
}
AVAILABILITY
Added in curl 8.16.0
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,
see libcurl-errors(3).
SEE ALSO
CURLMINFO_XFERS_CURRENT(3), CURLMINFO_XFERS_RUNNING(3)
libcurl 2026-03-23 CURLMINFO_XFERS_PENDING(3)
curl 8.19.0 - Generated Tue Mar 31 18:32:50 CDT 2026