CURLOPT_MAXCONNECTS(3)					     curl_easy_setopt options					    CURLOPT_MAXCONNECTS(3)

NAME

       CURLOPT_MAXCONNECTS - maximum connection cache size

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXCONNECTS, long amount);

DESCRIPTION

       Pass  a	long.  The  set amount will be the maximum number of simultaneously open persistent connections that libcurl may cache in the pool
       associated with this handle. The default is 5, and there isn't much point in changing this value unless you are perfectly aware of how this
       works and changes libcurl's behaviour. This concerns connections using any of the protocols that support persistent connections.

       When reaching the maximum limit, curl closes the oldest one in the cache to prevent increasing the number of open connections.

       If  you already have performed transfers with this curl handle, setting a smaller CURLOPT_MAXCONNECTS(3) than before may cause open connec-
       tions to get closed unnecessarily.

       If you add this easy handle to a multi handle, this setting is not acknowledged, and you must  instead  use  curl_multi_setopt(3)  and  the
       CURLMOPT_MAXCONNECTS(3) option.

DEFAULT

       5

PROTOCOLS

       Most

EXAMPLE

       TODO

AVAILABILITY

       Always

RETURN VALUE

       Returns CURLE_OK

SEE ALSO

       CURLMOPT_MAXCONNECTS(3), CURLOPT_MAXREDIRS(3),

libcurl 7.54.0							  April 18, 2016					    CURLOPT_MAXCONNECTS(3)