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.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Sets whether to use SSL for next transfers.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CURL 2.5 Yes Yes Yes Yes Yes
MBS( "CURL.SetOptionUseSSL"; curl; Value )   More

(old name: CURL.SetOptionFTPSSL)


Parameter Description Example value
curl The CURL session handle. $curl
Value The new SSL setting. 3


Returns "OK" on success.


Sets whether to use SSL for next transfers.
Pass a number using one of the values from below, to make libcurl use your desired level of SSL for the FTP transfer.

None0Don't attempt to use SSL.
Try1Try using SSL, proceed as normal otherwise.
Control2Require SSL for the control connection or fail with CURLE_USE_SSL_FAILED.
All3Require SSL for all communication or fail with CURLE_USE_SSL_FAILED.

Even as this function has FTP in name, we also use it for email sending. So the email upload starts unencrypted and we use TLS to upgrade to an SSL connection.

See also USE_SSL option in CURL manual.


Set to use SSL:

$r = MBS( "CURL.SetOptionUseSSL"; $curl; 3 )

Set to use TLSv1.2:

Set Variable [$r; MBS( "CURL.SetOptionUseSSL"; $curl; 3 ) ]
Set Variable [$r; MBS( "CURL.SetOptionSSLVersion"; $curl; 6 ) ]

Set URL for Gmail imap server:

Set Variable [$r; Value:MBS("CURL.SetOptionURL"; $curl; "imaps://")]
Set Variable [$r; Value:MBS("CURL.SetOptionUseSSL"; $curl; 3)]

See also

Example Databases

Blog Entries

Created 18th August 2014, last changed 5th February 2017

CURL.SetOptionUploadBufferSize   -   CURL.SetOptionUserAgent

Feedback: Report problem or ask question.

MBS Xojo Chart Plugins