Platforms to show: All Mac Windows Linux Cross-Platform
CURLSMBS.OptionFTPSSL as Integer
Function:
Request using SSL / TLS for the transfer.
Example:
Set to an integer using one of the values from below, to make libCURL use your desired level of SSL for the transfer.
These are all protocols that start out plain text and get "upgraded" to SSL using the STARTTLS command.
This is for enabling SSL/TLS when you use FTP, SMTP, POP3, IMAP etc.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Example:
dim c as CURLSMBS
c.OptionUseSSL = c.kFTPSSL_ALL
c.OptionSSLVersion = c.kSSLVersionTLSv12
This item is deprecated and should no longer be used.
You can use OptionUseSSL instead.
Notes:
Set to an integer using one of the values from below, to make libCURL use your desired level of SSL for the transfer.
These are all protocols that start out plain text and get "upgraded" to SSL using the STARTTLS command.
This is for enabling SSL/TLS when you use FTP, SMTP, POP3, IMAP etc.
| CURLUSESSL_NONE | 0 | Don't attempt to use SSL. |
| CURLUSESSL_TRY | 1 | Try using SSL, proceed as normal otherwise. |
| CURLUSESSL_CONTROL | 2 | Require SSL for the control connection or fail with CURLE_USE_SSL_FAILED. |
| CURLUSESSL_ALL | 3 | Require SSL for all communication or fail with CURLE_USE_SSL_FAILED. |
CURLSMBS.OptionFTPSSLAuth as Integer
Function:
What kind of SSL authentication to use for FTP.
Notes:
Pass an integer using one of the values from below, to alter how libCURL issues "AUTH TLS" or "AUTH SSL" when FTP over SSL is activated (see CURLOPT_FTP_SSL). (Added in 7.12.2)
kFTPAUTH_DEFAULT = 0
Allow libCURL to decide
kFTPAUTH_SSL = 1
Try "AUTH SSL" first, and only if that fails try "AUTH TLS"
kFTPAUTH_TLS = 2
Try "AUTH TLS" first, and only if that fails try "AUTH SSL"
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
Pass an integer using one of the values from below, to alter how libCURL issues "AUTH TLS" or "AUTH SSL" when FTP over SSL is activated (see CURLOPT_FTP_SSL). (Added in 7.12.2)
kFTPAUTH_DEFAULT = 0
Allow libCURL to decide
kFTPAUTH_SSL = 1
Try "AUTH SSL" first, and only if that fails try "AUTH TLS"
kFTPAUTH_TLS = 2
Try "AUTH TLS" first, and only if that fails try "AUTH SSL"
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 FTPSSLAUTH option in CURL manual.
CURLSMBS.OptionFTPSSLCCC as Integer
Function:
If enabled, this option makes libCURL use CCC (Clear Command Channel).
Notes:
It shuts down the SSL/TLS layer after authenticating. The rest of the control channel communication will be unencrypted. This allows NAT routers to follow the FTP transaction. Pass a long using one of the values below. (Added in 7.16.1)
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
It shuts down the SSL/TLS layer after authenticating. The rest of the control channel communication will be unencrypted. This allows NAT routers to follow the FTP transaction. Pass a long using one of the values below. (Added in 7.16.1)
| CURLFTPSSL_CCC_NONE | 0 | Don't attempt to use CCC. |
| CURLFTPSSL_CCC_PASSIVE | 1 | Do not initiate the shutdown, but wait for the server to do it. Do not send a reply. |
| CURLFTPSSL_CCC_ACTIVE | 2 | Initiate the shutdown and wait for a reply. |
See also FTP_SSL_CCC option in CURL manual.
CURLSMBS.OptionFTPUseEPRT as Boolean
Function:
If the value is true, it tells CURL to use the EPRT (and LPRT) command when doing active FTP downloads (which is enabled by CURLOPT_FTPPORT).
Notes:
Using EPRT means that it will first attempt to use EPRT and then LPRT before using PORT, but if you pass FALSE (zero) to this option, it will not try using EPRT or LPRT, only plain PORT. (Added in 7.10.5)
If the server is an IPv6 host, this option will have no effect as of 7.12.3.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
Using EPRT means that it will first attempt to use EPRT and then LPRT before using PORT, but if you pass FALSE (zero) to this option, it will not try using EPRT or LPRT, only plain PORT. (Added in 7.10.5)
If the server is an IPv6 host, this option will have no effect as of 7.12.3.
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 FTP_USE_EPRT option in CURL manual.
CURLSMBS.OptionFTPUseEPSV as Boolean
Function:
If the value is true, it tells CURL to use the EPSV command when doing passive FTP downloads (which it always does by default).
Notes:
Using EPSV means that it will first attempt to use EPSV before using PASV, but if you pass FALSE (zero) to this option, it will not try using EPSV, only plain PASV.
If the server is an IPv6 host, this option will have no effect as of 7.12.3.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
Using EPSV means that it will first attempt to use EPSV before using PASV, but if you pass FALSE (zero) to this option, it will not try using EPSV, only plain PASV.
If the server is an IPv6 host, this option will have no effect as of 7.12.3.
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 FTP_USE_EPSV option in CURL manual.
CURLSMBS.OptionFTPusePret as Boolean
Function:
If the value is true, it tells CURL to send a PRET command before PASV (and EPSV). Certain FTP servers, mainly drftpd, require this non-standard command for directory listings as well as up and downloads in PASV mode.
Notes:
Has no effect when using the active FTP transfers mode. (Added in 7.20.0)
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 11.0 | Yes | Yes | Yes | Yes | No |
Notes:
Has no effect when using the active FTP transfers mode. (Added in 7.20.0)
(Read and Write property)
See also FTP_USE_PRET option in CURL manual.
CURLSMBS.OptionGet as Boolean
Function:
If the true, this forces the HTTP request to get back to GET.
Notes:
usable if a POST, HEAD, PUT or a custom request have been used previously using the same CURL handle.
When setting OptionGet to a true value, it will automatically set OptionNoBody to true (since 7.14.1).
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
usable if a POST, HEAD, PUT or a custom request have been used previously using the same CURL handle.
When setting OptionGet to a true value, it will automatically set OptionNoBody to true (since 7.14.1).
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)
CURLSMBS.OptionGSSAPIDelegation as Integer
Function:
Allow GSSAPI credential delegation.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 18.2 | Yes | Yes | Yes | Yes | No |
Notes: (Read and Write property)
See also GSSAPI_DELEGATION option in CURL manual.
CURLSMBS.OptionHappyEyeballsTimeOutMS as Integer
Function:
The happy eyeballs timeout.
Notes:
Head start in milliseconds to give happy eyeballs.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 18.2 | Yes | Yes | Yes | Yes | No |
Notes:
Head start in milliseconds to give happy eyeballs.
(Read and Write property)
See also HAPPY_EYEBALLS_TIMEOUT_MS option in CURL manual.
CURLSMBS.OptionHAProxyProtocol as Boolean
Function:
Whether to send an HAProxy PROXY protocol header.
Notes:
Set to true to tell the library to send an HAProxy PROXY protocol header at beginning of the connection. The default action is not to send this header.
This option is primarily useful when sending test requests to a service that expects this header.
Most applications do not need this option.
Default false, do not send HAProxy PROXY protocol header.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 18.2 | Yes | Yes | Yes | Yes | No |
Notes:
Set to true to tell the library to send an HAProxy PROXY protocol header at beginning of the connection. The default action is not to send this header.
This option is primarily useful when sending test requests to a service that expects this header.
Most applications do not need this option.
Default false, do not send HAProxy PROXY protocol header.
(Read and Write property)
See also HAPROXYPROTOCOL option in CURL manual.
CURLSMBS.OptionHeader as Boolean
Function:
True tells the library to include the header in the body output.
Notes:
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.
This is only relevant for protocols that actually have headers preceding the data (like HTTP).
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
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.
This is only relevant for protocols that actually have headers preceding the data (like HTTP).
(Read and Write property)
See also HEADER option in CURL manual.
CURLSMBS.OptionHeaderOptions as Integer
Function:
Pass in a bitmask of "header options".
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 18.2 | Yes | Yes | Yes | Yes | No |
Notes: (Read and Write property)
See also HEADEROPT option in CURL manual.
CURLSMBS.OptionHTTPAuth as Integer
Function:
Which http authentication to use.
Notes:
Pass an integer as parameter, which is set to a bitmask, to tell libCURL what authentication method(s) you want it to use. The available bits are listed below. If more than one bit is set, libCURL will first query the site to see what authentication methods it supports and then pick the best one you allow it to use. For some methods, this will induce an extra network round-trip. Set the actual name and password with the UserPassword option. (Added in 7.10.6)
kAuthBASIC = 1
HTTP Basic authentication. This is the default choice, and the only method that is in wide-spread use and supported virtually everywhere. This is sending the user name and password over the network in plain text, easily captured by others.
kAuthDIGEST = 2
HTTP Digest authentication. Digest authentication is defined in RFC2617 and is a more secure way to do authentication over public networks than the regular old-fashioned Basic method.
kAuthGSSNEGOTIATE = 4
HTTP GSS-Negotiate authentication. The GSS-Negotiate (also known as plain "Negotiate") method was designed by Microsoft and is used in their web applications. It is primarily meant as a support for Kerberos5 authentication but may be also used along with another authentication methods. For more information see IETF draft draft-brezak-spnego-http-04.txt.
You need to build libCURL with a suitable GSS-API library for this to work.
kAuthNTLM = 8
HTTP NTLM authentication. A proprietary protocol invented and used by Microsoft. It uses a challenge-response and hash concept similar to Digest, to prevent the password from being eavesdropped.
You need to build libCURL with OpenSSL support for this option to work, or build libCURL on Windows.
kAuthANY = &hFFFFFFFF
This is a convenience macro that sets all bits and thus makes libCURL pick any it finds suitable. libCURL will automatically select the one it finds most secure.
kAuthANYSAFE = &hFFFFFFFE
This is a convenience macro that sets all bits except Basic and thus makes libCURL pick any it finds suitable. libCURL will automatically select the one it finds most secure.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
Pass an integer as parameter, which is set to a bitmask, to tell libCURL what authentication method(s) you want it to use. The available bits are listed below. If more than one bit is set, libCURL will first query the site to see what authentication methods it supports and then pick the best one you allow it to use. For some methods, this will induce an extra network round-trip. Set the actual name and password with the UserPassword option. (Added in 7.10.6)
kAuthBASIC = 1
HTTP Basic authentication. This is the default choice, and the only method that is in wide-spread use and supported virtually everywhere. This is sending the user name and password over the network in plain text, easily captured by others.
kAuthDIGEST = 2
HTTP Digest authentication. Digest authentication is defined in RFC2617 and is a more secure way to do authentication over public networks than the regular old-fashioned Basic method.
kAuthGSSNEGOTIATE = 4
HTTP GSS-Negotiate authentication. The GSS-Negotiate (also known as plain "Negotiate") method was designed by Microsoft and is used in their web applications. It is primarily meant as a support for Kerberos5 authentication but may be also used along with another authentication methods. For more information see IETF draft draft-brezak-spnego-http-04.txt.
You need to build libCURL with a suitable GSS-API library for this to work.
kAuthNTLM = 8
HTTP NTLM authentication. A proprietary protocol invented and used by Microsoft. It uses a challenge-response and hash concept similar to Digest, to prevent the password from being eavesdropped.
You need to build libCURL with OpenSSL support for this option to work, or build libCURL on Windows.
kAuthANY = &hFFFFFFFF
This is a convenience macro that sets all bits and thus makes libCURL pick any it finds suitable. libCURL will automatically select the one it finds most secure.
kAuthANYSAFE = &hFFFFFFFE
This is a convenience macro that sets all bits except Basic and thus makes libCURL pick any it finds suitable. libCURL will automatically select the one it finds most secure.
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 HTTPAUTH option in CURL manual.
CURLSMBS.OptionHTTPContentDecoding as Integer
Function:
Pass a long to tell libCURL how to act on content decoding.
Notes:
If set to zero, content decoding will be disabled. If set to 1 it is enabled. Note however that libCURL has no default content decoding but requires you to use OptionEncoding for that. (added in 7.16.2)
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
If set to zero, content decoding will be disabled. If set to 1 it is enabled. Note however that libCURL has no default content decoding but requires you to use OptionEncoding for that. (added in 7.16.2)
(Read and Write property)
See also HTTP_CONTENT_DECODING option in CURL manual.
CURLSMBS.OptionHTTPProxyTunnel as Boolean
Function:
Set the parameter to true to get the library to tunnel all operations through a given HTTP proxy.
Notes:
There is a big difference between using a proxy and to tunnel through it. If you don't know what this means, you probably don't want this tunneling option.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
There is a big difference between using a proxy and to tunnel through it. If you don't know what this means, you probably don't want this tunneling option.
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 HTTPPROXYTUNNEL option in CURL manual.
CURLSMBS.OptionHTTPTransferDecoding as Integer
Function:
Pass an integer to tell libCURL how to act on transfer decoding.
Notes:
If set to zero, transfer decoding will be disabled, if set to 1 it is enabled (default). libCURL does chunked transfer decoding by default unless this option is set to zero. (added in 7.16.2)
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
If set to zero, transfer decoding will be disabled, if set to 1 it is enabled (default). libCURL does chunked transfer decoding by default unless this option is set to zero. (added in 7.16.2)
(Read and Write property)
See also HTTP_TRANSFER_DECODING option in CURL manual.
CURLSMBS.OptionHTTPVersion as Integer
Function:
Set to one of the values described below.
Notes:
They force libCURL to use the specific HTTP versions. This is not sensible to do unless you have a good reason.
kHTTP_VERSION_NONE = 0
We don't care about what version the library uses. libCURL will use whatever it thinks fit.
kHTTP_VERSION_1_0 = 1
Enforce HTTP 1.0 requests.
kHTTP_VERSION_1_1 = 2
Enforce HTTP 1.1 requests.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
They force libCURL to use the specific HTTP versions. This is not sensible to do unless you have a good reason.
kHTTP_VERSION_NONE = 0
We don't care about what version the library uses. libCURL will use whatever it thinks fit.
kHTTP_VERSION_1_0 = 1
Enforce HTTP 1.0 requests.
kHTTP_VERSION_1_1 = 2
Enforce HTTP 1.1 requests.
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 HTTP_VERSION option in CURL manual.
CURLSMBS.OptionIgnoreContentLength as Boolean
Function:
Whether to ignore the Content-Length header.
Notes:
This is useful for Apache 1.x (and similar servers) which will report incorrect content length for files over 2 gigabytes. If this option is used, CURL will not be able to accurately report progress, and will simply stop the download when the server ends the connection. (added in 7.14.1)
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
This is useful for Apache 1.x (and similar servers) which will report incorrect content length for files over 2 gigabytes. If this option is used, CURL will not be able to accurately report progress, and will simply stop the download when the server ends the connection. (added in 7.14.1)
(Read and Write property)
See also IGNORE_CONTENT_LENGTH option in CURL manual.
CURLSMBS.OptionInFileSize as Int64
Function:
When uploading a file to a remote site, this option should be used to tell libCURL what the expected size of the infile is.
Notes:
Note that this option does not limit how much data libCURL will actually send, as that is controlled entirely by what the read callback returns.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
Note that this option does not limit how much data libCURL will actually send, as that is controlled entirely by what the read callback returns.
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 INFILESIZE option in CURL manual.
CURLSMBS.OptionInFileSizeLarge as Int64
Function:
When uploading a file to a remote site, this option should be used to tell libCURL what the expected size of the infile is.
This value should be passed as a CURL_off_t. (Added in 7.11.0)
Note that this option does not limit how much data libCURL will actually send, as that is controlled entirely by what the read callback returns.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
This item is deprecated and should no longer be used.
You can use OptionInFileSize instead.
Notes:
This value should be passed as a CURL_off_t. (Added in 7.11.0)
Note that this option does not limit how much data libCURL will actually send, as that is controlled entirely by what the read callback returns.
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)
CURLSMBS.OptionInterface as String
Function:
This set the interface name to use as outgoing network interface.
Notes:
The name can be an interface name, an IP address or a host name.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
The name can be an interface name, an IP address or a host name.
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 INTERFACE option in CURL manual.
CURLSMBS.OptionIPResolve as Integer
Function:
Allows an application to select what kind of IP addresses to use when resolving host names.
Example:
Notes:
This is only interesting when using host names that resolve addresses using more than one version of IP. The allowed values are:
kIPRESOLVE_WHATEVER = 0
Default, resolves addresses to all IP versions that your system allows.
kIPRESOLVE_V4 = 1
Resolve to ipv4 addresses.
kIPRESOLVE_V6 = 2
Resolve to ipv6 addresses.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Example:
dim c as new CURLSMBS
c.OptionIPResolve = c.kIPRESOLVE_V4
This is only interesting when using host names that resolve addresses using more than one version of IP. The allowed values are:
kIPRESOLVE_WHATEVER = 0
Default, resolves addresses to all IP versions that your system allows.
kIPRESOLVE_V4 = 1
Resolve to ipv4 addresses.
kIPRESOLVE_V6 = 2
Resolve to ipv6 addresses.
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 IPRESOLVE option in CURL manual.
CURLSMBS.OptionIssuerCert as String
Function:
A string naming a file holding a CA certificate in PEM format.
Notes:
If the option is set, an additional check against the peer certificate is performed to verify the issuer is indeed the one associated with the certificate provided by the option. This additional check is useful in multi-level PKI where one needs to enforce that the peer certificate is from a specific branch of the tree.
This option makes sense only when used in combination with the OptionSSLVerifyPeer option. Otherwise, the result of the check is not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option, which is returned if the setup of the SSL/TLS session has failed due to a mismatch with the issuer of peer certificate (OptionSSLVerifyPeer has to be set too for the check to fail). (Added in 7.19.0)
Starting with version 18.0 the plugin will always use UTF-8 encoding for file path on Linux and macOS. For macOS we also do the unicode character normalization for file names for you.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 10.0 | Yes | Yes | Yes | Yes | No |
Notes:
If the option is set, an additional check against the peer certificate is performed to verify the issuer is indeed the one associated with the certificate provided by the option. This additional check is useful in multi-level PKI where one needs to enforce that the peer certificate is from a specific branch of the tree.
This option makes sense only when used in combination with the OptionSSLVerifyPeer option. Otherwise, the result of the check is not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option, which is returned if the setup of the SSL/TLS session has failed due to a mismatch with the issuer of peer certificate (OptionSSLVerifyPeer has to be set too for the check to fail). (Added in 7.19.0)
Starting with version 18.0 the plugin will always use UTF-8 encoding for file path on Linux and macOS. For macOS we also do the unicode character normalization for file names for you.
(Read and Write property)
See also ISSUERCERT option in CURL manual.
CURLSMBS.OptionKeepSendingOnError as Integer
Function:
Whether to keep sending on error.
Notes:
Continue to send data if the server responds early with an HTTP status code >= 300
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 18.2 | Yes | Yes | Yes | Yes | No |
Notes:
Continue to send data if the server responds early with an HTTP status code >= 300
(Read and Write property)
See also KEEP_SENDING_ON_ERROR option in CURL manual.
CURLSMBS.OptionKeyPassword as String
Function:
Set passphrase to private key.
Notes:
It will be used as the password required to use the OptionSSLKey or OptionSSHPrivateKeyfile private key. You never needed a pass phrase to load a certificate but you need one to load your private key.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 15.2 | Yes | Yes | Yes | Yes | No |
Notes:
It will be used as the password required to use the OptionSSLKey or OptionSSHPrivateKeyfile private key. You never needed a pass phrase to load a certificate but you need one to load your private key.
(Read and Write property)
See also KEYPASSWD option in CURL manual.
CURLSMBS.OptionKRB4Level as String
Function:
Set the krb4 security level, this also enables krb4 awareness.
This is a string, 'clear', 'safe', 'confidential' or 'private'. If the string is set but doesn't match one of these, 'private' will be used. Set the string to "" to disable kerberos4. The kerberos support only works for FTP.
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
This item is deprecated and should no longer be used.
You can use OptionKRBLevel instead.
Notes:
This is a string, 'clear', 'safe', 'confidential' or 'private'. If the string is set but doesn't match one of these, 'private' will be used. Set the string to "" to disable kerberos4. The kerberos support only works for FTP.
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)
CURLSMBS.OptionKRBLevel as String
Function:
FTP kerberos security level.
Notes:
Set the kerberos security level for FTP; this also enables kerberos awareness. This is a string that should match one of the following: 'clear', 'safe', 'confidential' or 'private'. If the string is set but doesn't match one of these, 'private' will be used. Set the string to NULL to disable kerberos support for FTP.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 15.2 | Yes | Yes | Yes | Yes | No |
Notes:
Set the kerberos security level for FTP; this also enables kerberos awareness. This is a string that should match one of the following: 'clear', 'safe', 'confidential' or 'private'. If the string is set but doesn't match one of these, 'private' will be used. Set the string to NULL to disable kerberos support for FTP.
(Read and Write property)
See also KRBLEVEL option in CURL manual.
CURLSMBS.OptionLocalPort as Integer
Function:
This sets the local port number of the socket used for connection.
Notes:
This can be used in combination with OptionInterface and you are recommended to use OptionLocalPortRange as well when this is set. Note that port numbers are only valid 1 - 65535. (Added in 7.15.2)
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
This can be used in combination with OptionInterface and you are recommended to use OptionLocalPortRange as well when this is set. Note that port numbers are only valid 1 - 65535. (Added in 7.15.2)
(Read and Write property)
See also LOCALPORT option in CURL manual.
CURLSMBS.OptionLocalPortRange as Integer
Function:
This is the number of attempts libCURL should do to find a working local port number.
Notes:
It starts with the given OptionLocalPort and adds one to the number for each retry. Setting this value to 1 or below will make libCURL do only one try for exact port number. Note that port numbers by nature is a scarce resource that will be busy at times so setting this value to something too low might cause unnecessary connection setup failures. (Added in 7.15.2)
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 9.8 | Yes | Yes | Yes | Yes | No |
Notes:
It starts with the given OptionLocalPort and adds one to the number for each retry. Setting this value to 1 or below will make libCURL do only one try for exact port number. Note that port numbers by nature is a scarce resource that will be busy at times so setting this value to something too low might cause unnecessary connection setup failures. (Added in 7.15.2)
(Read and Write property)
See also LOCALPORTRANGE option in CURL manual.
CURLSMBS.OptionLoginOptions as String
Function:
Login options string to use for the transfer.
Notes:
For more information about the login options please see RFC 2384, RFC5092 and IETF draft draft-earhart-url-smtp-00.txt
CURLOPT_LOGIN_OPTIONS can be used to set protocol specific login options, such as the preferred authentication mechanism via "AUTH=NTLM" or "AUTH=*", and should be used in conjunction with the OptionUserName option.
Only IMAP, POP3 and SMTP support login options.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | Console & Web | iOS |
| property | CURL | MBS CURL Plugin | 15.4 | Yes | Yes | Yes | Yes | No |
Notes:
For more information about the login options please see RFC 2384, RFC5092 and IETF draft draft-earhart-url-smtp-00.txt
CURLOPT_LOGIN_OPTIONS can be used to set protocol specific login options, such as the preferred authentication mechanism via "AUTH=NTLM" or "AUTH=*", and should be used in conjunction with the OptionUserName option.
Only IMAP, POP3 and SMTP support login options.
(Read and Write property)
See also LOGIN_OPTIONS option in CURL manual.
The items on this page are in the following plugins: MBS CURL Plugin.
Links
MBS Xojo Chart Plugins
