DN/External/curl-8.17.0/docs/libcurl/opts/CURLMINFO_XFERS_ADDED.md

1.2 KiB

c SPDX-License-Identifier Title Section Source See-also Protocol Added-in
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl CURLMINFO_XFERS_ADDED 3 libcurl
CURLMINFO_XFERS_CURRENT (3)
CURLMINFO_XFERS_RUNNING (3)
CURLMINFO_XFERS_DONE (3)
All
8.16.0

NAME

CURLMINFO_XFERS_ADDED - Cumulative number of all easy handles added

SYNOPSIS

#include <curl/curl.h>

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

DESCRIPTION

The cumulative number of all easy handles added to the multi, ever. This includes internal handles added for tasks (like resolving via DoH, for example).

For the current number of easy handles managed by the multi, use CURLMINFO_XFERS_CURRENT(3).

DEFAULT

n/a

%PROTOCOLS%

EXAMPLE

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

  curl_multi_get_offt(m, CURLMINFO_XFERS_ADDED, &value);
}

%AVAILABILITY%

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