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.1   7.2   7.3   7.4   7.5   8.0   8.1   8.2   8.3   8.4    Statistic  

CURL.SetOptionTCPKeepAlive

Enable TCP keep-alive probing.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CURL 5.2 Yes Yes Yes Yes Yes

MBS( "CURL.SetOptionTCPKeepAlive"; Handle; Value )

Parameters

Parameter Description Example value
Handle The CURL session handle. $curl
Value The new setting. 1 = on and 0 = off. 1

Result

Returns OK or error.

Description

Enable TCP keep-alive probing.
If set to 1, TCP keepalive probes will be sent. The delay and frequency of these probes can be controlled by the CURL.SetOptionTCPKeepIdle and CURL.SetOptionTCPKeepInterval options, provided the operating system supports them. Set to 0 (default behavior) to disable keepalive probes.

See also TCP_KEEPALIVE option in CURL manual.

Examples

Configure keep alive:

#Enable TCP keep-alive for this transfer
Set Variable [$r; Value:MBS( "CURL.SetOptionTCPKeepAlive"; $curl; 1 )]
#keep-alive idle time to 120 seconds
Set Variable [$r; Value:MBS( "CURL.SetOptionTCPKeepIdle"; $curl; 120 )]
#interval time between keep-alive probes: 60 seconds
Set Variable [$r; Value:MBS( "CURL.SetOptionTCPKeepInterval"; $curl; 60 )]

See also

Created 8th July 2015, last changed 9th July 2015


CURL.SetOptionTCPFastOpen   -   CURL.SetOptionTCPKeepIdle

Feedback: Report problem or ask question.




Links
MBS Xojo blog