CURLMINFO_XFERS_CURRENT(3)

CURLMINFO_XFERS_CURRENT3

Number of easy handles currently added

Usage

#include <curl/curl.h>
CURLMcode curl_multi_get_offt(CURLM *handle, CURLMINFO_XFERS_CURRENT,
                              curl_off_t *pvalue);

Overview

Returns the number of easy handles currently added to the multi handle. This does not include already removed handles. It does include internal handles that get added for tasks (like resolving via DoH, for example).

For the total number of easy handles ever added to the multi, see CURLMINFO_XFERS_ADDED(3).

Default

n/a

Protocols

This functionality affects all supported protocols

Examples

int main(void)
{
  CURLM *m = curl_multi_init();
  curl_off_t value;
  curl_multi_get_offt(m, CURLMINFO_XFERS_CURRENT, &value);
}

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).

Availability

Added in curl 8.16.0

From curl 8.23.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.