curlmopt_maxconnects(3) [mojave man page]

CURLMOPT_MAXCONNECTS(3) 				     curl_multi_setopt options					   CURLMOPT_MAXCONNECTS(3)

NAME

       CURLMOPT_MAXCONNECTS - set size of connection cache

SYNOPSIS

       #include <curl/curl.h>

       CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAXCONNECTS, long max);

DESCRIPTION

       Pass  a long indicating the max. The set number will be used as the maximum amount of simultaneously open connections that libcurl may keep
       in its connection cache after completed use. By default libcurl will enlarge the size for each added easy handle to make it fit 4 times the
       number of added easy handles.

       By setting this option, you can prevent the cache size from growing beyond the limit set by you.

       When the cache is full, curl closes the oldest one in the cache to prevent the number of open connections from increasing.

       This option is for the multi handle's use only, when using the easy interface you should instead use the CURLOPT_MAXCONNECTS(3) option.

       See CURLMOPT_MAX_TOTAL_CONNECTIONS(3) for limiting the number of active connections.

DEFAULT

       See DESCRIPTION

PROTOCOLS

       All

EXAMPLE

       TODO

AVAILABILITY

       Added in 7.16.3

RETURN VALUE

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

SEE ALSO

       CURLMOPT_MAX_HOST_CONNECTIONS(3), CURLOPT_MAXCONNECTS(3),

libcurl 7.54.0							 February 03, 2016					   CURLMOPT_MAXCONNECTS(3)

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)