CURLMOPT_MAX_TOTAL_CONNECTIONS(3)

1CURLMOPT_MAX_TOTAL_CONNECTIOcNuSr(l3_)multi_setopt oCpUtRiLoMnOsPT_MAX_TOTAL_CONNECTIONS(3)
2
3
4

NAME

6       CURLMOPT_MAX_TOTAL_CONNECTIONS - max simultaneously open connections
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLMcode  curl_multi_setopt(CURLM  *handle, CURLMOPT_MAX_TOTAL_CONNEC‐
12       TIONS, long amount);
13

DESCRIPTION

15       Pass a long for the amount. The set number will be used as the  maximum
16       number  of  simultaneously  open  connections in total using this multi
17       handle. For each new session, libcurl will open a new connection up  to
18       the  limit  set by CURLMOPT_MAX_TOTAL_CONNECTIONS(3). When the limit is
19       reached, the sessions will be pending until there are available connec‐
20       tions.  If  CURLMOPT_PIPELINING(3)  is enabled, libcurl will try to use
21       multiplexing if the host is capable of it.
22
23       When more transfers are added to the multi handle than what can be per‐
24       formed  due  to the set limit, they will be queued up waiting for their
25       chance. When that happens, the CURLOPT_TIMEOUT_MS(3)  timeout  will  be
26       counted  inclusive  of  the waiting time, meaning that if you set a too
27       narrow timeout in such a case the transfer might never even  start  be‐
28       fore it times out.
29
30       Even in the queued up situation, the CURLOPT_CONNECTTIMEOUT_MS(3) time‐
31       out is however treated as a per-connect timeout.
32

DEFAULT

34       The default value is 0, which means that there is no limit. It is  then
35       simply controlled by the number of easy handles added.
36

PROTOCOLS

38       All
39

EXAMPLE

41       CURLM *m = curl_multi_init();
42       /* never do more than 15 connections */
43       curl_multi_setopt(m, CURLMOPT_MAX_TOTAL_CONNECTIONS, 15L);
44

AVAILABILITY

46       Added in 7.30.0
47

RETURN VALUE

49       Returns  CURLM_OK  if the option is supported, and CURLM_UNKNOWN_OPTION
50       if not.
51