NAME

       CURLMOPT_MAX_TOTAL_CONNECTIONS - max simultaneously open connections

SYNOPSIS

       #include <curl/curl.h>

       CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_TOTAL_CONNECTIONS, long amount);

DESCRIPTION

       Pass  a  long  for  the  amount.  The  set  number  will  be used as the maximum number of
       simultaneously open connections in total using this multi handle. For  each  new  session,
       libcurl    will    open    a    new    connection    up    to    the    limit    set    by
       CURLMOPT_MAX_TOTAL_CONNECTIONS(3). When the limit is reached, the sessions will be pending
       until  there are available connections. If CURLMOPT_PIPELINING(3) is enabled, libcurl will
       try to pipeline or use multiplexing if the host is capable of it.

DEFAULT

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

PROTOCOLS

       All

EXAMPLE

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

AVAILABILITY

       Added in 7.30.0

RETURN VALUE

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

SEE ALSO

       CURLMOPT_MAXCONNECTS(3), CURLMOPT_MAX_HOST_CONNECTIONS(3),