Platforms to show: All Mac Windows Linux Cross-Platform
Back to CURLMBS class.
CURLMBS.OptionSSLKeyType as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Supported formats are "PEM", "DER" and "ENG".
The format "ENG" enables you to load the private key from a crypto engine. In this case OptionSSLKEY is used as an identifier passed to the engine. You have to set the crypto engine with OptionSSLENGINE. "DER" format key file currently does not work because of a bug in OpenSSL.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also SSLKEYTYPE option in CURL manual.
CURLMBS.OptionSSLOptions as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also SSL_OPTIONS option in CURL manual.
CURLMBS.OptionSSLSessionIDCache as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Pass false to disable libCURL's use of SSL session-ID caching. Set this to true to enable it. By default all transfers are done using the cache. Note that while nothing ever should get hurt by attempting to reuse SSL session-IDs, there seem to be broken SSL implementations in the wild that may require you to disable this in order for you to succeed. (Added in 7.16.0)
(Read and Write property)
See also SSL_SESSIONID_CACHE option in CURL manual.
CURLMBS.OptionSSLVerifyHost as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
When negotiating an SSL connection, the server sends a certificate indicating its identity.
When OptionSSLVerifyHost is 2, that certificate must indicate that the server is the server to which you meant to connect, or the connection fails.
CURL considers the server the intended one when the Common Name field or a Subject Alternate Name field in the certificate matches the host name in the URL to which you told CURL to connect.
When the value is 1, the certificate must contain a Common Name field, but it doesn't matter what name it says. (This is not ordinarily a useful setting).
When the value is 0, the connection succeeds regardless of the names in the certificate.
The default, since 7.10, is 2.
The checking this option controls is of the identity that the server claims. The server could be lying. To control lying, see OptionSSLVerifyPeer.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
When you don't set the options for certificate path or load system certificates, the MBS Plugin will disable the verify step to let the transfer run.
(Read and Write property)
See also SSL_VERIFYHOST option in CURL manual.
CURLMBS.OptionSSLVerifyPeer as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This option determines whether CURL verifies the authenticity of the peer's certificate. A value of 1 means CURL verifies; zero means it doesn't. The default is nonzero, but before 7.10, it was zero.
When negotiating an SSL connection, the server sends a certificate indicating its identity. CURL verifies whether the certificate is authentic, i.e. that you can trust that the server is who the certificate says it is. This trust is based on a chain of digital signatures, rooted in certification authority (CA) certificates you supply. As of 7.10, CURL installs a default bundle of CA certificates and you can specify alternate certificates with the OptionCAINFO option or the OptionCAPATH option.
When OptionSSLVerifyPeer is nonzero, and the verification fails to prove that the certificate is authentic, the connection fails. When the option is zero, the connection succeeds regardless.
Authenticating the certificate is not by itself very useful. You typically want to ensure that the server, as authentically identified by its certificate, is the server you mean to be talking to. Use OptionSSLVerifyHost to control that.
When you don't set the options for certificate path or load system certificates, the MBS Plugin will disable the verify step to let the transfer run.
(Read and Write property)
See also SSL_VERIFYPEER option in CURL manual.
CURLMBS.OptionSSLVerifyStatus as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also SSL_VERIFYSTATUS option in CURL manual.
CURLMBS.OptionSSLVersion as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
The SSL and TLS versions have typically developed from the most insecure version to be more and more secure in this order through history: SSL v2, SSLv3, TLS v1.0, TLS v1.1, TLS v1.2 and the most recent TLS v1.3.
Use one of the available defines for this purpose. The available options are:
Default | 0 | The default acceptable version range. The minimum acceptable version is by default TLS v1.0 since 7.39.0 (unless the TLS library has a stricter rule). |
TLSv1 | 1 | TLS v1.0 or later |
SSLv2 | 2 | SSL v2 (but not SSLv3) |
SSLv3 | 3 | SSL v3 (but not SSLv2) |
TLSv1.0 | 4 | TLS v1.0 or later (Added in 7.34.0) |
TLSv1.1 | 5 | TLS v1.1 or later (Added in 7.34.0) |
TLSv1.2 | 6 | TLS v1.2 or later (Added in 7.34.0) |
TLSv1.3 | 7 | TLS v1.3 or later (Added in 7.52.0) |
See also kSSLVersion* constants.
The maximum TLS version can be set by using one of the CURL_SSLVERSION_MAX_ macros below. It is also possible to OR one of the CURL_SSLVERSION_ macros with one of the CURL_SSLVERSION_MAX_ macros.
Default | &h10000 | The flag defines the maximum supported TLS version by libcurl, or the default value from the SSL library is used. libcurl will use a sensible default maximum, which was TLS v1.2 up to before 7.61.0 and is TLS v1.3 since then - assuming the TLS library support it. (Added in 7.54.0) |
Max TLSv1.0 | &h40000 | The flag defines maximum supported TLS version as TLS v1.0. (Added in 7.54.0) |
Max TLSv1.1 | &h50000 | The flag defines maximum supported TLS version as TLS v1.1. (Added in 7.54.0) |
Max TLSv1.2 | &h60000 | The flag defines maximum supported TLS version as TLS v1.2. (Added in 7.54.0) |
Max TLSv1.3 | &h70000 | The flag defines maximum supported TLS version as TLS v1.3. (Added in 7.54.0) |
Please note that MBS Plugin does not yet support TLS v1.3 now, but may in future.
(Read and Write property)
See also SSLVERSION option in CURL manual.
CURLMBS.OptionStreamDepends as CURLMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also STREAM_DEPENDS option in CURL manual.
CURLMBS.OptionStreamDependsE as CURLMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also STREAM_DEPENDS_E option in CURL manual.
CURLMBS.OptionStreamWeight as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Default is 16.
(Read and Write property)
See also STREAM_WEIGHT option in CURL manual.
CURLMBS.OptionSuppressConnectHeaders as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also SUPPRESS_CONNECT_HEADERS option in CURL manual.
CURLMBS.OptionTCPFastOpen as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also TCP_FASTOPEN option in CURL manual.
CURLMBS.OptionTCPKeepAlive as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
The delay and frequency of these probes can be controlled by the OptionTCPKeepIdle and OptionTCPKeepInterval options, provided the operating system supports them. Set to false (default behavior) to disable keepalive probes (Added in 7.25.0).
(Read and Write property)
See also TCP_KEEPALIVE option in CURL manual.
CURLMBS.OptionTCPKeepIdle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Not all operating systems support this option. (Added in 7.25.0)
(Read and Write property)
See also TCP_KEEPIDLE option in CURL manual.
CURLMBS.OptionTCPKeepInterval as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Not all operating systems support this option. (Added in 7.25.0)
(Read and Write property)
See also TCP_KEEPINTVL option in CURL manual.
CURLMBS.OptionTCPNoDelay as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
The option is cleared by default. This will have no effect after the connection has been established.
Setting this option will disable TCP's Nagle algorithm. The purpose of this algorithm is to try to minimize the number of small packets on the network (where "small packets" means TCP segments less than the Maximum Segment Size (MSS) for the network).
Maximizing the amount of data sent per TCP segment is good because it amortizes the overhead of the send. However, in some cases (most notably telnet or rlogin) small segments may need to be sent without delay. This is less efficient than sending larger amounts of data at a time, and can contribute to congestion on the network if overdone.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TCP_NODELAY option in CURL manual.
CURLMBS.OptionTFTPBlockSize as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 10.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Valid range as per RFC 2348 is 8-65464 bytes. The default of 512 bytes will be used if this option is not specified. The specified block size will only be used pending support by the remote server. If the server does not return an option acknowledgement or returns an option acknowledgement with no blksize, the default of 512 bytes will be used. (added in 7.19.4)
(Read and Write property)
See also TFTP_BLKSIZE option in CURL manual.
CURLMBS.OptionTFTPNoOptions as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also TFTP_NO_OPTIONS option in CURL manual.
CURLMBS.OptionTimeCondition as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This defines how the OptionTimeValue time value is treated. You can set this parameter to kTimeConditionIfModifiedSince (1) or kTimeConditionIfUnModifiedSince (2). This feature applies to HTTP and FTP.
The last modification time of a file is not always known and in such instances this feature will have no effect even if the given time condition would have not been met.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TIMECONDITION option in CURL manual.
CURLMBS.OptionTimeOut as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Normally, name lookups can take a considerable time and limiting operations to less than a few minutes risk aborting perfectly normal operations. This option will cause CURL to use the SIGALRM to enable time-outing system calls.
In unix-like systems, this might cause signals to be used unless CURLOPT_NOSIGNAL is set.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TIMEOUT option in CURL manual.
CURLMBS.OptionTimeOutMS as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Normally, name lookups can take a considerable time and limiting operations to less than a few minutes risk aborting perfectly normal operations. This option will cause CURL to use the SIGALRM to enable time-outing system calls.
(Read and Write property)
See also TIMEOUT_MS option in CURL manual.
CURLMBS.OptionTimeValue as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TIMEVALUE option in CURL manual.
CURLMBS.OptionTLS13Ciphers as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.3 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
string holding the list of cipher suites to use for the TLS 1.3 connection. The list must be syntactically correct, it consists of one or more cipher suite strings separated by colons.
You'll find more details about cipher lists on this URL:
https://curl.haxx.se/docs/ssl-ciphers.html
The application does not have to keep the string around after setting this option.
(Read and Write property)
See also TLS13_CIPHERS option in CURL manual.
CURLMBS.OptionTLSAuthPassword as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 13.5 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Please also set OptionTLSAuthType.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TLSAUTH_PASSWORD option in CURL manual.
CURLMBS.OptionTLSAuthType as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 13.5 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
You can set this to "SRP" to use Secure Remote Password authentication.
Please also set username and password.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TLSAUTH_TYPE option in CURL manual.
CURLMBS.OptionTLSAuthUsername as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 13.5 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Please also set OptionTLSAuthType.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TLSAUTH_USERNAME option in CURL manual.
CURLMBS.OptionTransferEncoding as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 13.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
If the server supports this and so desires, it can respond with the HTTP response sent using a compressed Transfer-Encoding that will be automatically uncompressed by libCURL on reception.
Transfer-Encoding differs slightly from the Content-Encoding you ask for with OptionAcceptEncoding in that a Transfer-Encoding is strictly meant to be for the transfer and thus MUST be decoded before the data arrives in the client. Traditionally, Transfer-Encoding has been much less used and supported by both HTTP clients and HTTP servers.
(Read and Write property)
See also TRANSFER_ENCODING option in CURL manual.
CURLMBS.OptionTransferText as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
For win32 systems it does not set the stdout to binary mode. This option can be usable when transferring text data between systems with different views on certain characters, such as newlines or similar.
libCURL does not do a complete ASCII conversion when doing ASCII transfers over FTP. This is a known limitation/flaw that nobody has rectified. libCURL simply sets the mode to ascii and performs a standard transfer.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also TRANSFERTEXT option in CURL manual.
CURLMBS.OptionUnixSocketPath as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write property)
See also UNIX_SOCKET_PATH option in CURL manual.
CURLMBS.OptionUnrestrictedAuth as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This option is meaningful only when setting FollowOption.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
(Read and Write property)
See also UNRESTRICTED_AUTH option in CURL manual.
The items on this page are in the following plugins: MBS CURL Plugin.