Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.2   7.3   7.4   7.5   8.0   8.1   8.2   8.3   8.4   8.5    Statistic  

CURL.Upkeep

Perform any connection upkeep checks.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CURL 8.5 Yes Yes Yes Yes Yes
MBS( "CURL.Upkeep"; curl )   More

Parameters

Parameter Description Example value
curl The CURL session handle. $curl

Result

Returns OK or error.

Description

Perform any connection upkeep checks.
Some protocols have "connection upkeep" mechanisms. These mechanisms usually send some traffic on existing connections in order to keep them alive; this can prevent connections from being closed due to overzealous firewalls, for example.
Currently the only protocol with a connection upkeep mechanism is HTTP/2: when the connection upkeep interval is exceeded and CURL.Upkeep is called, an HTTP/2 PING frame is sent on the connection.
This function must be explicitly called in order to perform the upkeep work. The connection upkeep interval is set with CURL.SetOptionUpkeepIntervalMS.

See also

Created 31st October 2018, last changed 31st October 2018


CURL.SetupOAuth   -   CURL.UseSystemCertificates

Feedback: Report problem or ask question.




Links
MBS Xojo blog