Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 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.54.1			 May 27, 2017	       CURLMOPT_MAXCONNECTS(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLMOPT_MAXCONNECTS&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help