Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

CURLNMBS.OptionProxySSLVerifyPeer 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
Function: Set if we should verify the proxy in ssl handshake.
Example:
// if you use SSL, maybe put in a certificate or disable verification?

dim d as CURLNMBS
// your CURL object

// disable
d.OptionProxySSLVerifyHost = 0
d.OptionProxySSLVerifyPeer = 0

// or better provide root certificates:

Dim cacert As FolderItem = GetFolderItem("cacert.pem")
d.OptionProxyCAInfo = cacert.NativePath
d.OptionProxySSLVerifyHost = 2
d.OptionProxySSLVerifyPeer = 1
Notes:
set 1 to verify.
(Read and Write property)

See also PROXY_SSL_VERIFYPEER option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxySSLVersion 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
Function: What version to specifically try to use for proxy.
Notes:
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:

Default0The 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).
TLSv11TLS v1.0 or later
SSLv22SSL v2 (but not SSLv3)
SSLv33SSL v3 (but not SSLv2)
TLSv1.04TLS v1.0 or later (Added in 7.34.0)
TLSv1.15TLS v1.1 or later (Added in 7.34.0)
TLSv1.26TLS v1.2 or later (Added in 7.34.0)
TLSv1.37TLS 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&h10000The 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&h40000The flag defines maximum supported TLS version as TLS v1.0. (Added in 7.54.0)
Max TLSv1.1&h50000The flag defines maximum supported TLS version as TLS v1.1. (Added in 7.54.0)
Max TLSv1.2&h60000The flag defines maximum supported TLS version as TLS v1.2. (Added in 7.54.0)
Max TLSv1.3&h70000The 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 PROXY_SSLVERSION option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxyTLS13Ciphers 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
Function: Specify which TLS 1.3 ciphers suites to use for proxy.
Notes:
The list of cipher suites to use for the TLS 1.3 connection to a proxy. 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 PROXY_TLS13_CIPHERS option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxyTLSAuthPassword 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
Function: Password for authenticated TLS for proxy.
Notes: (Read and Write property)

See also PROXY_TLSAUTH_PASSWORD option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxyTLSAuthType 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
Function: Set authentication type for authenticated TLS for proxy
Notes: (Read and Write property)

See also PROXY_TLSAUTH_TYPE option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxyTLSAuthUsername 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
Function: Set a username for authenticated TLS for proxy.
Notes: (Read and Write property)

See also PROXY_TLSAUTH_USERNAME option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxyTransferMode 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
Function: If this integer value is set to 1 (one), it tells libCURL to set the transfer mode (binary or ASCII) for FTP transfers done via an HTTP proxy, by appending ;type=a or ;type=i to the URL.
Notes:
Without this setting, or it being set to 0 (zero, the default), OptionTransferText has no effect when doing FTP via a proxy. Beware that not all proxies support this feature. (Added in 7.18.0)
(Read and Write property)

See also PROXY_TRANSFER_MODE option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxyType 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
Function: This option is to set type of the proxy.
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.

Available options for this are kPROXY_HTTP, kPROXY_SOCKS4 (added in 7.15.2) kPROXY_SOCKS5. The HTTP type is default.
(Read and Write property)

See also PROXYTYPE option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionProxyUsername as String
Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 10.0 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop, Console & Web
Function: A string, which should be pointing to the user name to use for the transfer while connecting to Proxy.
Notes:
In order to specify the password to be used in conjunction with the user name use the OptionProxyPassword option.
(Read and Write property)

See also PROXYUSERNAME option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionPut 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
Function: A non-zero parameter tells the library to use HTTP PUT to transfer data.
Notes:
The data should be set with OptionInFileSize.

This option is deprecated and starting with version 7.12.1 you should instead use OptionUpload.

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 PUT option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRandomFile 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
Function: A file name for the random file.
Notes:
The file will be used to read from to seed the random engine for SSL. The more random the specified file is, the more secure the SSL connection will become.

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.

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 RANDOM_FILE option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRange 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
Function: A string which should contain the specified range you want.
Notes:
It should be in the format "X-Y", where X or Y may be left out. HTTP transfers also support several intervals, separated with commas as in "X-Y,N-M". Using this kind of multiple intervals will cause the HTTP server to send the response document in pieces (using standard MIME separation techniques). Pass a NULL to this option to disable the use of ranges.

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 RANGE option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRedirProtocols 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
Function: An integer that holds a bitmask of kProtocol* constants.
Notes:
If used, this bitmask limits what protocols libCURL may use in a transfer that it follows to in a redirect when OptionFollowLocation is enabled. This allows you to limit specific transfers to only be allowed to use a subset of protocols in redirections. By default libCURL will allow all protocols except for FILE and SCP. This is a difference compared to pre-7.19.4 versions which unconditionally would follow to all protocols supported. (Added in 7.19.4)
(Read and Write property)

See also REDIR_PROTOCOLS option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionReferer 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
Function: The referer to pass to the server.
Notes:
It will be used to set the Referer: header in the http request sent to the remote server. This can be used to fool servers or scripts. You can also set any custom header with OptionHTTPHeader.

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 REFERER option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRequestTarget 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
Function: The request target, instead of extracted from the URL.
Notes: (Read and Write property)

See also REQUEST_TARGET option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionResumeFrom as Int64
Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop, Console & Web
Function: It contains the offset in number of bytes that you want the transfer to start from.
Notes:
Set this option to 0 to make the transfer start from the beginning (effectively disabling resume). For FTP, set this option to -1 to make the transfer start from the end of the target file (useful to continue an interrupted upload).

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 RESUME_FROM option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionResumeFromLarge as Int64
Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop, Console & Web
Function: It contains the offset in number of bytes that you want the transfer to start from.
This item is deprecated and should no longer be used. You can use OptionResumeFrom instead.
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.
(Read and Write property)

Feedback, Comments & Corrections

CURLNMBS.OptionRTSPClientCSEQ 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
Function: Manually initialize the client RTSP CSeq for this handle.
Notes: (Read and Write property)

See also RTSP_CLIENT_CSEQ option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRTSPRequest 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
Function: RTSP request method (OPTIONS, SETUP, PLAY, etc...).
Notes: (Read and Write property)

See also RTSP_REQUEST option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRTSPServerCSEQ 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
Function: Manually initialize the server RTSP CSeq for this handle.
Notes: (Read and Write property)

See also RTSP_SERVER_CSEQ option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRTSPSessionID 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
Function: The RTSP session identifier.
Notes: (Read and Write property)

See also RTSP_SESSION_ID option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRTSPStreamURI 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
Function: The RTSP stream URI.
Notes: (Read and Write property)

See also RTSP_STREAM_URI option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionRTSPTransport 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
Function: The Transport: header to use in RTSP requests.
Notes: (Read and Write property)

See also RTSP_TRANSPORT option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionSASLAuthZID as String
Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 19.4 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop, Console & Web
Function: The authorisation identity (identity to act as).
Notes:
Sets the authorisation identity (identity to act as).
Pass a text as parameter, which should be pointing to the authorisation identity (authzid) for the transfer. Only applicable to the PLAIN SASL authentication mechanism where it is optional.
When not specified only the authentication identity (authcid) as specified by the username will be sent to the server, along with the password. The server will derive a authzid from the authcid when not provided, which it will then uses internally.
When the authzid is specified, the use of which is server dependent, it can be used to access another user's inbox, that the user has been granted access to, or a shared mailbox for example.
(Read and Write property)

See also SASL_AUTHZID option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionSASLIR 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
Function: Enable/disable SASL initial response.
Notes: (Read and Write property)

See also SASL_IR option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionServiceName 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
Function: Service Name.
Notes: (Read and Write property)

See also SERVICE_NAME option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionSocks5Auth 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
Function: Bitmask of allowed auth methods for connections to SOCKS5 proxies.
Notes: (Read and Write property)

See also SOCKS5_AUTH option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionSocks5GSSAPINEC as Boolean
Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 10.0 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop, Console & Web
Function: Whether to protect SOCKS5 connection is protected.
Notes:
Set to true to enable or false to disable. As part of the gssapi negotiation a protection mode is negotiated. The rfc1961 says in section 4.3/4.4 it should be protected, but the NEC reference implementation does not. If enabled, this option allows the unprotected exchange of the protection mode negotiation. (Added in 7.19.4).
(Read and Write property)

See also SOCKS5_GSSAPI_NEC option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionSocks5GSSAPIService as String
Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 10.0 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop, Console & Web
Function: A string holding the name of the service.
Notes:
The default service name for a SOCKS5 server is rcmd/server-fqdn. This option allows you to change it. (Added in 7.19.4)
(Read and Write property)

See also SOCKS5_GSSAPI_SERVICE option in CURL manual.

Feedback, Comments & Corrections

CURLNMBS.OptionSSHAuthTypes 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
Function: Define the SSH authorization types.
Notes:
Pass a long set to a bitmask consisting of one or more of CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST, CURLSSH_AUTH_KEYBOARD. Set CURLSSH_AUTH_ANY to let libCURL pick one. (Added in 7.16.1)

constants:
CURLSSH_AUTH_ANY = &hFFFFFFFF
CURLSSH_AUTH_NONE = 0
CURLSSH_AUTH_PUBLICKEY = 1
CURLSSH_AUTH_PASSWORD = 2
CURLSSH_AUTH_HOST = 4
CURLSSH_AUTH_KEYBOARD = 8
CURLSSH_AUTH_DEFAULT = CURLSSH_AUTH_ANY
(Read and Write property)

See also SSH_AUTH_TYPES option in CURL manual.

Feedback, Comments & Corrections

Previous items Next items

The items on this page are in the following plugins: MBS CURL Plugin.

The biggest plugin in space...




Links
MBS Xojo Plugins

Start Chat