CURLMOPT_MAXCONNECTS(3) curl_multi_setopt options CURLMOPT_MAXCONNECTS(3)
NAME
CURLMOPT_MAXCONNECTS - 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 max-
imum amount of simultaneously open connections that libcurl may keep in
its connection cache after completed use. By default libcurl will en-
large 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 be-
yond the limit set by you.
When the cache is full, curl closes the oldest one in the cache to pre-
vent the number of open connections from increasing.
This option is for the multi handle's use only, when using the easy in-
terface 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
CURLM *m = curl_multi_init();
/* only keep 10 connections in the cache */
curl_multi_setopt(m, CURLMOPT_MAXCONNECTS, 10L);
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.81.0 November 26, 2021 CURLMOPT_MAXCONNECTS(3)
Generated by dwww version 1.14 on Fri Dec 5 05:44:30 CET 2025.