CURLMOPT_MAX_TOTAL_CONNECTIONS(3)

CURLMOPT_MAX_TOTAL_CONNECTIONS(3curl_multi_setopt optionCURLMOPT_MAX_TOTAL_CONNECTIONS(3)

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 avail-
     able connections. If CURLMOPT_PIPELINING(3) is enabled, lib-
     curl 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),

libcurl 7.58.0      Last change: May 27, 2017                   1