Xojo Conferences
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

CURLMBS.OptionRedirProtocols as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 10.0 Yes Yes Yes Yes No
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

CURLMBS.OptionReferer as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
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

CURLMBS.OptionRequestTarget as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
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

CURLMBS.OptionResumeFrom as Int64
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
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

CURLMBS.OptionResumeFromLarge as Int64
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
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

CURLMBS.OptionRTSPClientCSEQ as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
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

CURLMBS.OptionRTSPRequest as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: RTSP request method (OPTIONS, SETUP, PLAY, etc...).
Notes: (Read and Write property)

See also RTSP_REQUEST option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionRTSPServerCSEQ as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
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

CURLMBS.OptionRTSPSessionID as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: The RTSP session identifier.
Notes: (Read and Write property)

See also RTSP_SESSION_ID option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionRTSPStreamURI as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: The RTSP stream URI.
Notes: (Read and Write property)

See also RTSP_STREAM_URI option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionRTSPTransport as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
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

CURLMBS.OptionSASLIR as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: Enable/disable SASL initial response.
Notes: (Read and Write property)

See also SASL_IR option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionServiceName as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: Service Name.
Notes: (Read and Write property)

See also SERVICE_NAME option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionSocks5Auth as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
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

CURLMBS.OptionSocks5GSSAPINEC as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 10.0 Yes Yes Yes Yes No
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

CURLMBS.OptionSocks5GSSAPIService as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 10.0 Yes Yes Yes Yes No
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

CURLMBS.OptionSSHAuthTypes as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
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

CURLMBS.OptionSSHCompression as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: Enable/disable SSH compression.
Notes: (Read and Write property)

See also SSH_COMPRESSION option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionSSHHostPublicKeyMD5 as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 10.0 Yes Yes Yes Yes No
Function: A string containing 32 hexadecimal digits with the 128 bit MD5 checksum of the remote host's public key.
Notes:
libCURL will reject the connection to the host unless the md5sums match. This option is only for SCP and SFTP transfers. (Added in 7.17.1)
(Read and Write property)

See also SSH_HOST_PUBLIC_KEY_MD5 option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionSSHKnownhosts as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 10.0 Yes Yes Yes Yes No
Function: A string holding the file name of the known_host file to use.
Notes:
The known_hosts file should use the OpenSSH file format as supported by libssh2. If this file is specified, libCURL will only accept connections with hosts that are known and present in that file, with a matching public key. (Added in 7.19.6)
(Read and Write property)

See also SSH_KNOWNHOSTS option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionSSHPrivateKeyfile as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
Function: Pass a path pointing to a file name for your private key.
Notes:
If not used, libCURL defaults to using ~/.ssh/id_dsa. If the file is password-protected, set the password with OptionSSLKeyPassword. (Added in 7.16.1)

For a SFTP transfer (= file transfer over SSH), you would tell the plugin your public and private keys, so the plugin can login.

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

Feedback, Comments & Corrections

CURLMBS.OptionSSHPublicKeyfile as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
Function: Pass a path pointing to a file name for your public key.
Notes:
If not used, libCURL defaults to using ~/.ssh/id_dsa.pub. (Added in 7.16.1)

For a SFTP transfer (= file transfer over SSH), you would tell the plugin your public and private keys, so the plugin can login.

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

Feedback, Comments & Corrections

CURLMBS.OptionSSLCert as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
Function: The string should be the file name of your certificate.
Notes:
The default format is "PEM" and can be changed with OptionSSLCERTTYPE.

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

Feedback, Comments & Corrections

CURLMBS.OptionSSLCertPassword as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 11.3 Yes Yes Yes Yes No
Function: The certificate password.
This item is deprecated and should no longer be used. You can use OptionKeyPassword instead.
Notes: (Read and Write property)

Feedback, Comments & Corrections

CURLMBS.OptionSSLCertType as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
Function: The string should be the format of your certificate.
Notes:
Supported formats are "PEM" and "DER". (Added in 7.9.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 SSLCERTTYPE option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionSSLCipherList as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
Function: A string holding the list of ciphers to use for the SSL connection.
Notes:
The list must be syntactically correct, it consists of one or more cipher strings separated by colons. Commas or spaces are also acceptable separators but colons are normally used, !, - and + can be used as operators. Valid examples of cipher lists include 'RC4-SHA', 'SHA1+DES', 'TLSv1' and 'DEFAULT'. The default list is normally set when you compile OpenSSL.

You'll find more details about cipher lists on this URL:

http://www.openssl.org/docs/apps/ciphers.html

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

Feedback, Comments & Corrections

CURLMBS.OptionSSLEnableALPN as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: Enable/disable TLS ALPN extension (http2 over ssl might fail without).
Notes: (Read and Write property)

See also SSL_ENABLE_ALPN option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionSSLEnableNPN as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 18.2 Yes Yes Yes Yes No
Function: Enable/disable TLS NPN extension (http2 over ssl might fail without)
Notes: (Read and Write property)

See also SSL_ENABLE_NPN option in CURL manual.

Feedback, Comments & Corrections

CURLMBS.OptionSSLEngine as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
Function: It will be used as the identifier for the crypto engine you want to use for your private key.
Notes:
If the crypto device cannot be loaded, kError_SSL_ENGINE_NOTFOUND is returned.

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

Feedback, Comments & Corrections

CURLMBS.OptionSSLEngineDefault as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property CURL MBS CURL Plugin 9.8 Yes Yes Yes Yes No
Function: Sets the actual crypto engine as the default for (asymmetric) crypto operations.
Notes:
If the crypto device cannot be set, kError_SSL_ENGINE_SETFAILED is returned.

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

Feedback, Comments & Corrections

Previous items Next items

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




Links
MBS FileMaker tutorial videos