CURLMINFO\_XFERS\_PENDING(3) Library Functions Manual CURLMINFO\_XFERS\_PENDING(3)

# [NAME](#NAME)

CURLMINFO\_XFERS\_PENDING - Number of easy handles waiting to start

# [SYNOPSIS](#SYNOPSIS)

```
#include <curl/curl.h>
CURLMcode curl_multi_get_offt(CURLM *handle, CURLMINFO_XFERS_PENDING,


                              curl_off_t *pvalue);
```

# [DESCRIPTION](#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](#DEFAULT)

n/a

# [PROTOCOLS](#PROTOCOLS)

This functionality affects all supported protocols

# [EXAMPLE](#EXAMPLE)

```
int main(void)
{


  CURLM *m = curl_multi_init();


  curl_off_t value;


  curl_multi_get_offt(m, CURLMINFO_XFERS_PENDING, &value);
}
```

# [AVAILABILITY](#AVAILABILITY)

Added in curl 8.16.0

# [RETURN VALUE](#RETURN_VALUE)

[*curl\_multi\_get\_offt(3)*](/man/os/curl/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)*](/man/os/curl/libcurl-errors.3).

# [SEE ALSO](#SEE_ALSO)

[**CURLMINFO\_XFERS\_CURRENT**(3)](/man/os/curl/CURLMINFO_XFERS_CURRENT.3), [**CURLMINFO\_XFERS\_RUNNING**(3)](/man/os/curl/CURLMINFO_XFERS_RUNNING.3)

2026-10-14 libcurl

---

Document: CURLMINFO_XFERS_PENDING(3) from curl 8.23.0-r0 (Chainguard OS)
Source: https://github.com/curl/curl.git