Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

CURL.SetOptionProtocols

Limit which protocols are used.

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

Deprecated

This function was deprecated. Use CURL.SetOptionProtocolsString instead.

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

Parameters

Parameter Description Example
curl The CURL session handle. $curl
Value The bitmask defining which protocols to use. 1

Result

Returns "OK" on success.

Description

Limit which protocols are used.
Pass a number that holds a bitmask of protocol values (See below). If used, this bitmask limits what protocols libcurl may use in the transfer. This allows us to have a plugin built to support a wide range of protocols but still limit specific transfers to only be allowed to use a subset of them. By default libcurl will accept all protocols it supports. See also CURL.SetOptionRedirProtocols.

HTTP1
HTTPS2
FTP4
FTPS8
SCP16
SFTP32
TELNET64
LDAP128
LDAPS256
DICT512
FILE1024
TFTP2048
IMAP4096
IMAPS8192
POP316384
POP3S32768
SMTP65536
SMTPS131072
RTSP262144
ALL-1

Examples

Allow only HTTP and HTTPS:

MBS( "CURL.SetOptionProtocols"; $curl; 1 + 2 )

See also

Release notes

Blog Entries

Created 18th August 2014, last changed 21st December 2022


CURL.SetOptionPreQuote - CURL.SetOptionProtocolsString