| 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.
| HTTP | 1 |
| HTTPS | 2 |
| FTP | 4 |
| FTPS | 8 |
| SCP | 16 |
| SFTP | 32 |
| TELNET | 64 |
| LDAP | 128 |
| LDAPS | 256 |
| DICT | 512 |
| FILE | 1024 |
| TFTP | 2048 |
| IMAP | 4096 |
| IMAPS | 8192 |
| POP3 | 16384 |
| POP3S | 32768 |
| SMTP | 65536 |
| SMTPS | 131072 |
| RTSP | 262144 |
| ALL | -1 |
Examples
Allow only HTTP and HTTPS:
MBS( "CURL.SetOptionProtocols"; $curl; 1 + 2 )
See also
- CURL.SetOptionPathAsIs
- CURL.SetOptionPostFields
- CURL.SetOptionPostQuote
- CURL.SetOptionPreQuote
- CURL.SetOptionProtocolsString
- CURL.SetOptionProxyAuth
- CURL.SetOptionProxyPort
- CURL.SetOptionProxyType
- CURL.SetOptionRedirProtocols
- CURL.SetOptionRedirProtocolsString
Release notes
- Version 13.0
- Deprecated CURL.SetOptionProtocols in favor of CURL.SetOptionProtocolsString function.
Blog Entries
Created 18th August 2014, last changed 24th June 2025
