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.3   7.4   7.5   8.0   8.1   8.2   8.3   8.4   8.5   8.6    Statistic  

CURL.SetOptionUseSSL

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)

Parameters

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

Result

Returns "OK" on success.

Description

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.

Examples

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://imap.gmail.com/INBOX")]
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.



Links
MBS Xojo tutorial videos