Monkeybread Software - MBS FileMaker Plugin: CURL.SetOptionMaxConnects

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

CURL.SetOptionMaxConnects

Sets the persistent connection cache size.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
CURL	2.5	Yes	Yes	Yes	Yes	Yes

MBS( "CURL.SetOptionMaxConnects"; curl; Value ) More

Parameters

Parameter Description Example

curl The CURL session handle. $curl

Value The new limit. 5

Parameter	Description	Example
curl	The CURL session handle.	$curl
Value	The new limit.	5

Result

Returns "OK" on success.

Description

Sets the persistent connection cache size.
The set amount will be the maximum amount of simultaneously open connections that libcurl may cache in this easy handle. 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 MaxConnects than before may cause open connections to get closed unnecessarily.

See also MAXCONNECTS option in CURL manual.