Platforms to show: All Mac Windows Linux Cross-Platform

Back to CURLSMBS class.

Next items

CURLSMBS.Cancel as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 13.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Tells CURL instance to cancel transfer as soon as possible.

Especially when using PerformMT, you may see your app hang if user tries to quit application. To prevent the hang, please set Cancel = true in window close event. So when app quits and windows get destroyed, the PerformMT will see the Cancel being true and returns soon.
(Read and Write property)

CURLSMBS.CollectDebugData as Boolean   Deprecated

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 12.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
This item is deprecated and should no longer be used. You can use CollectDebugMessages instead.
Whether to collect debug message data.

If you set this property to true, you can grab the data from the transfer in the DebugMessages Property instead of collecting the pieces yourself in the DebugMessage event. Of course this is optional and you can still process data in DebugMessage event.
Due to memory limitation, collecting data will not work right if your app is running low on memory.
(Read and Write property)

CURLSMBS.CollectDebugMessages as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 23.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Whether to collect debug message data.

If you set this property to true, you can grab the data from the transfer in the DebugMessages Property instead of collecting the pieces yourself in the DebugMessage event. Of course this is optional and you can still process data in DebugMessage event.
Due to memory limitation, collecting data will not work right if your app is running low on memory.
(Read and Write property)

CURLSMBS.CollectHeaderData as Boolean   Deprecated

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 12.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
This item is deprecated and should no longer be used. You can use CollectHeaders instead.
Whether to collect headers.

If you set this property to true, you can grab the data from the transfer in the Headers Property instead of collecting the pieces yourself in the header event. Of course this is optional and you can still process data in header event.
Due to memory limitation, collecting data will not work right if your app is running low on memory.

Renamed to CollectHeaders in v23.0.
(Read and Write property)

CURLSMBS.CollectHeaders as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 23.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Whether to collect headers.

If you set this property to true, you can grab the data from the transfer in the Headers Property instead of collecting the pieces yourself in the header event. Of course this is optional and you can still process data in header event.
Due to memory limitation, collecting data will not work right if your app is running low on memory.
(Read and Write property)

CURLSMBS.CollectOutputData as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 12.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Whether to collect output data.

If you set this property to true, you can grab the data from the transfer in the OutputData Property instead of collecting the pieces yourself in the write event. Of course this is optional and you can still process data in write event.
Due to memory limitation, collecting data will not work right if your app is running low on memory.
(Read and Write property)

CURLSMBS.DebugData as String   Deprecated

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 12.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
This item is deprecated and should no longer be used. You can use DebugMessages instead.
The debug data from CURL.

If CollectDebugData property is true, the plugin puts the data received in debugMessage event also into this property, so you can grab it after the transfer.

Newer code should use DebugMessages property instead.
(Read only property)

CURLSMBS.DebugMessages as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 23.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The debug messages from CURL.

If CollectDebugMessage property is true, the plugin puts the data received in debugMessage event also into this property, so you can grab it after the transfer.
(Read only property)

CURLSMBS.DebugWithData as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 18.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Whether to include data in debug messages.
Example

dim c as new CURLSMBS
c.DebugWithData = true
c.OptionVerbose = true
c.CollectDebugMessages = true

(Read and Write property)

CURLSMBS.Handle as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The internal handle of the CURL object.

(Read and Write property)

CURLSMBS.HeaderData as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 12.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The headers from CURL.

If CollectHeaders property is true, the plugin puts the data received in header event also into this property, so you can grab it after the transfer.

Renamed to Headers in v23.0.
(Read only property)

CURLSMBS.Headers as String   Deprecated

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 23.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
This item is deprecated and should no longer be used. You can use Headers instead.
The headers from CURL.

If CollectHeaders property is true, the plugin puts the data received in header event also into this property, so you can grab it after the transfer.
(Read only property)

CURLSMBS.InputData as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 14.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The input data.

If you set input data, you do not need to use Read, RestartRead or Seek events.
The plugin will use the provided data for the upload.
Setting input data size, will also set the input file size (OptionInFileSizeLarge and OptionInFileSize).

Alternatively you can provide data in Read event or use OpenMTInputFile method to open a file on disk to upload.
(Read and Write property)

CURLSMBS.Lasterror as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The lasterror from the library.
Example

Dim d As New CURLSMBS

d.OptionSSLVersion = 123

Dim LastError As Integer = d.LastError
// gives 43
Dim LastErrorText As String = d.LastErrorText
// A libcurl function was given a bad argument

Break

Set in the constructor while doing initialization as well as by by various curl calls.
Check the kError* constants.
(Read and Write property)

CURLSMBS.LastErrorMessage as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The last error message.
Example

Dim d As New CURLSMBS

d.OptionURL = "http://192.168.2.53"
d.OptionConnectionTimeout = 5

Dim ErrorCode As Integer = d.Perform

Dim LastErrorMessage As String = d.LastErrorMessage
Dim LastErrorText As String = d.LastErrorText

Break

The error message from the transfer.

e.g. Perform may report a timeout with code 28.
Then LasterrorText is "Timeout was reached" looked up for 28.

But LasterrorMessage would be something like "Failed to connect to x.x.x.x port 80 after 5000 ms: Timeout was reached".
(Read only property)

CURLSMBS.LasterrorText as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 18.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The text for the lasterror code.
Example

Dim d As New CURLSMBS

d.OptionURL = "http://192.168.2.53"
d.OptionConnectionTimeout = 5

Dim ErrorCode As Integer = d.Perform

Dim LastErrorMessage As String = d.LastErrorMessage
Dim LastErrorText As String = d.LastErrorText

Break

Static string matched to the error code, so you have an idea what's wrong.

e.g. Perform may report a timeout with code 28.
Then LasterrorText is "Timeout was reached" looked up for 28.

But LasterrorMessage would be something like "Failed to connect to x.x.x.x port 80 after 5000 ms: Timeout was reached".
(Read and Write property)

CURLSMBS.OptionAbstractUnixSocket as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 18.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Path to an abstract Unix domain socket.

(Read and Write property)

See also ABSTRACT_UNIX_SOCKET option in CURL manual.

CURLSMBS.OptionAcceptEncoding as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 13.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the contents of the Accept-Encoding: header sent in a HTTP request, and enables decoding of a response when a Content-Encoding: header is received.
Example
dim c as new CURLSMBS
c.OptionAcceptEncoding = "deflate"

Three encodings are supported: identity, which does nothing, deflate which requests the server to compress its response using the zlib algorithm, and gzip which requests the gzip algorithm. If a zero-length string is set, then an Accept-Encoding: header containing all supported encodings is sent.

This is a request, not an order; the server may or may not do it. This option must be set (to any non-NULL value) or else any unsolicited encoding done by the server is ignored. See the special file README.encoding for details (included with CURL source code).
(Read and Write property)

See also ACCEPT_ENCODING option in CURL manual.

CURLSMBS.OptionAcceptTimeoutMS as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 18.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Time-out accept operations (currently for FTP only) after this amount of milliseconds.

(Read and Write property)

See also ACCEPTTIMEOUT_MS option in CURL manual.

CURLSMBS.OptionAddressScope as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 10.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Pass an integer specifying the scope_id value to use when connecting to IPv6 link-local or site-local addresses.

(Added in CURL 7.19.0)
(Read and Write property)

See also ADDRESS_SCOPE option in CURL manual.

CURLSMBS.OptionAppend as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 15.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
True tells the library to append to the remote file instead of overwrite it.

This is only useful when uploading to an ftp site.

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

CURLSMBS.OptionAutoReferer as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
When enabled, libCURL will automatically set the Referer: field in requests where it follows a Location: redirect.

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

CURLSMBS.OptionAWSSigV4 as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 21.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Provides AWS V4 signature authentication on HTTP(S) header.

Pass a text that is the collection of specific arguments are used for creating outgoing authentication headers. The format of the param option is:

provider1[:provider2[:region[:service]]]

provider1, provider2:
The providers arguments are used for generating some authentication parameters such as "Algorithm", "date", "request type" and "signed headers".

region:
The argument is a geographic area of a resources collection. It is extracted from the host name specified in the URL if omitted.

service:
The argument is a function provided by a cloud. It is extracted from the host name specified in the URL if omitted.

Note: This call set CURLOPT_HTTPAUTH to CURLAUTH_AWS_SIGV4. Calling CURLOPT_HTTPAUTH with CURLAUTH_AWS_SIGV4 is the same as calling this with "aws:amz" in parameter.

Example with "Test:Try", when curl will do the algorithm, it will generate "TEST-HMAC-SHA256" for "Algorithm", "x-try-date" and "X-Try-Date" for "date", "test4_request" for "request type", "SignedHeaders=content-type;host;x-try-date" for "signed headers"
If you use just "test", instead of "test:try", test will be use for every strings generated

By default, the value of this parameter is empty. Calling CURLOPT_HTTPAUTH with CURLAUTH_AWS_SIGV4 is the same as calling this with "aws:amz" in parameter.
(Read and Write property)

See also AWS_SIGV4 option in CURL manual.

CURLSMBS.OptionBufferSize as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Your preferred size (in bytes) for the receive buffer in libCURL.

The main point of this would be that the write event gets called more often and with smaller chunks. This is just treated as a request, not an order. You cannot be guaranteed to actually get the given size. (Added in 7.10)

This size is by default set as big as possible (OptionMaxWriteSize), so it only makse sense to use this option if you want it smaller.

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.

For slow upload/downloads, it may be better to set buffer size to 1 MB with OptionUploadBufferSize or OptionBufferSize properties to make transfers faster.
(Read and Write property)

See also BUFFERSIZE option in CURL manual.

CURLSMBS.OptionCACacheTimeout as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 23.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the life-time for cached certificate stores.

Pass a number, this sets the timeout in seconds. This tells libcurl the maximum time any cached certificate store it has in memory may be kept and reused for new connections. Once the timeout has expired, a subsequent fetch requiring a certificate store will have to build a new one.
Building a certificate store from a CAINFO file (see OptionCAInfo) is a slow operation so curl may cache the generated certificate store internally to speed up future connections.
Set to zero to completely disable caching, or set to -1 to retain the cached store remain forever. By default, libcurl caches this info for 24 hours.
(Read and Write property)

See also CA_CACHE_TIMEOUT option in CURL manual.

CURLSMBS.OptionCAInfo as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
A string naming a file holding one or more certificates to verify the peer with.
Example
// if you use SSL, maybe put in a certificate or disable verification?

dim d as CURLSMBS
// your CURL object

// disable
d.OptionSSLVerifyHost = 0
d.OptionSSLVerifyPeer = 0

// or better provide root certificates:

Dim cacert As FolderItem = GetFolderItem("cacert.pem")
d.OptionCAInfo = cacert.NativePath
d.OptionSSLVerifyHost = 2
d.OptionSSLVerifyPeer = 1

This makes sense only when used in combination with the OptionSSLVerifyPeer option. If OptionSSLVerifyPeer is false, OptionCAINFO need not even indicate an accessible file.

Note that option is by default set to the system path where libCURL's cacert bundle is assumed to be stored, as established at build time.

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

CURLSMBS.OptionCAInfoBlob as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 21.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The CAInfo as blob value.

Certificate Authority (CA) bundle in PEM format passed PEM encoded content holding one or more certificates to verify the HTTPS server with.
(Read and Write property)

See also CAINFO_BLOB option in CURL manual.

CURLSMBS.OptionCAPath as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
A string naming a directory holding multiple CA certificates to verify the peer with.
Example
dim c as new CURLSMBS
c.OptionCAPath = "/data/MyCertificates"

The certificate directory must be prepared using the openssl c_rehash utility. This makes sense only when used in combination with the CURLOPT_SSL_VERIFYPEER option. If OptionSSLVerifyPeer is zero, OptionCAPath need not even indicate an accessible path. The OptionCAPath function apparently does not work in Windows due to some limitation in openssl. This option is OpenSSL-specific and does nothing if libCURL is built to use GnuTLS.

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

CURLSMBS.OptionCertInfo as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 10.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Set to true to enable libCURL's certificate chain info gatherer.

With this enabled, libCURL (if built with OpenSSL) will extract lots of information and data about the certificates in the certificate chain used in the SSL connection. This data is then possible to extract after a transfer using GetInfoCertInfo. (Added in 7.19.1)
(Read and Write property)

See also CERTINFO option in CURL manual.

CURLSMBS.OptionConnectionTimeout as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The maximum time in seconds that you allow the connection to the server to take.
Example
dim d as new CURLSMBS

d.OptionConnectionTimeOutMS = 5000
d.OptionConnectOnly = 1

// try this URL
d.OptionURL = URL

// try connection
dim e as integer = d.Perform

// check result
dim s as string = d.OutputData
TextArea1.text = FixText(S)

if e = 0 then
MsgBox "Connected"
else
MsgBox "Failed to connect"
end if

This only limits the connection phase, once it has connected, this option is of no more use. Set to zero to disable connection timeout (it will then only timeout on the system's internal timeouts). See also the OptionTimeout option.
(Read and Write property)

See also CONNECTTIMEOUT option in CURL manual.

CURLSMBS.OptionConnectionTimeOutMS as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The maximum time in milli seconds that you allow the connection to the server to take.

This only limits the connection phase, once it has connected, this option is of no more use. Set to zero to disable connection timeout (it will then only timeout on the system's internal timeouts). See also the OptionTimeout option.
(Read and Write property)

CURLSMBS.OptionConnectOnly as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
A true tells the library to perform any required proxy authentication and connection setup, but no data transfer.

This option is useful with the CURLSMBS.GetInfoLastSocket function. The library can set up the connection and then the application can obtain the most recently used socket for special data transfers. (Added in 7.15.2)

Type changed to integer in v23.0 to enable passing 2 for WebSockets.
(Read and Write property)

See also CONNECT_ONLY option in CURL manual.

CURLSMBS.OptionCookie as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
It will be used to set a cookie in the http request.

The format of the string should be NAME=CONTENTS, where NAME is the cookie name and CONTENTS is what the cookie should contain.

If you need to set multiple cookies, you need to set them all using a single option and thus you need to concatenate them all in one single string. Set multiple cookies in one string like this: "name1=content1; name2=content2;" etc.

Using this option multiple times will only make the latest string override the previously ones.

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

CURLSMBS.OptionCookieFile as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The cookie file content.

It should contain the name of your file holding cookie data to read. The cookie data may be in Netscape / Mozilla cookie data format or just regular HTTP-style headers dumped to a file.

Given an empty or non-existing file or by passing the empty string (""), this option will enable cookies for this CURL handle, making it understand and parse received cookies and then use matching cookies in future request.

If you use this option multiple times, you just add more files to read. Subsequent files will add more cookies.

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

CURLSMBS.OptionCookieJar as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
File path where to write the cookies to.

This will make libCURL write all internally known cookies to the specified file, when the object is destroyed. If no cookies are known, no file will be created. Specify "-" to instead have the cookies written to stdout. Using this option also enables cookies for this session, so if you for example follow a location it will make matching cookies get sent accordingly.

If the cookie jar file can't be created or written to, libCURL will not and cannot report an error for this. Using OptionVerbose or DebugFunction event will get a warning to display, but that is the only visible feedback you get about this possibly lethal situation.

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

CURLSMBS.OptionCookieList as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The cookie string.

Cookie can be either in Netscape / Mozilla format or just regular HTTP-style header (Set-Cookie: ...) format. If CURL cookie engine was not enabled it will enable its cookie engine. Passing a magic string "ALL" will erase all cookies known by CURL. (Added in 7.14.1) Passing the special string "SESS" will only erase all session cookies known by CURL. (Added in 7.15.4)

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

CURLSMBS.OptionCookieSession as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Set to true to mark this as a new cookie "session".

It will force libCURL to ignore all cookies it is about to load that are "session cookies" from the previous session. By default, libCURL always stores and loads all cookies, independent if they are session cookies are not. Session cookies are cookies without expiry date and they are meant to be alive and existing for this "session" only.

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

CURLSMBS.OptionCRLF as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 9.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Convert Unix newlines to CRLF newlines on transfers.

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

CURLSMBS.OptionCRLFile as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property CURL MBS CURL Plugin 10.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
A string naming a file with the concatenation of CRL (in PEM format) to use in the certificate validation that occurs during the SSL exchange.

When CURL is built to use NSS or GnuTLS, there is no way to influence the use of CRL passed to help in the verification process. When libCURL is built with OpenSSL support, X509_V_FLAG_CRL_CHECK and X509_V_FLAG_CRL_CHECK_ALL are both set, requiring CRL check against all the elements of the certificate chain if a CRL file is passed.

This option makes sense only when used in combination with the OptionSSLVerifyPeer option.

A specific error code (CURLE_SSL_CRL_BADFILE) is defined with the option. It is returned when the SSL exchange fails because the CRL file cannot be loaded. Note that a failure in certificate verification due to a revocation information found in the CRL does not trigger this specific error. (Added in 7.19.0)
(Read and Write property)

See also CRLFILE option in CURL manual.

Next items

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


The biggest plugin in space...