Information describing the Curl library

This function queries the Curl library to provide information about its characteristics when it was compiled. This tells the user about its capabilities and can be used to determine strategies.

curlVersion(id = 0)

Arguments

id

an integer value between 0 and 3 inclusive. The idea is that one specifies the identifier for the version of interest. In fact, all values seem to yield the same result.

Value

A list

age

integer giving the number of this libcurl, 0 is FIRST, 1 is SECOND, 2 is THIRD

version

the version identifier as a string, e.g. "7.12.0"

version_num

the value as an integer

host

the machine on which the libcurl was configured/built.

features

a named integer vector of bits indicating what features of libcurl were configured and built into this version. These are features such as ipv6, ssl, libz, largefile, ntlm (Microsoft "authorization").

ssl_version

the string identifying the SSL version.

ssl_version_num

the number identifying the SSL version

libz_version

the string identifying the version of libz.

protocols

a character vector of the supported HTTP protocols, e.g. http, https, ftp, ldap, gopher, telnet

ares

name of the asynchronous DNS (domain name service) lookup library. This is often simply the empty string indicating it is not there.

ares_num

the number for the ares library

libidn

the name of the IDN (internationalized domain names) library being used. This field only appears in version 3 of libcurl. If you are using version 2 (e.g. curl-7.11.2), this will be NA. An empty string indicates that the field is present, but has no value.

See the man page for curl_version_info for a description of these fields. features in R is a named integer vector detailing the different features.

References

Curl homepage https://curl.se/

Author

Duncan Temple Lang

See also

curl_version_info in the libcurl documentation.

Examples

  curlVersion()
#> $age
#> [1] 10
#> 
#> $version
#> [1] "8.5.0"
#> 
#> $vesion_num
#> [1] 525568
#> 
#> $host
#> [1] "x86_64-pc-linux-gnu"
#> 
#> $features
#>        ipv6         ssl        libz        ntlm   asynchdns      spnego 
#>           1           4           8          16         128         256 
#>   largefile         idn tlsauth_srp 
#>         512        1024       16384 
#> 
#> $ssl_version
#> [1] "OpenSSL/3.0.13"
#> 
#> $ssl_version_num
#> [1] 0
#> 
#> $libz_version
#> [1] "1.3"
#> 
#> $protocols
#>  [1] "dict"    "file"    "ftp"     "ftps"    "gopher"  "gophers" "http"   
#>  [8] "https"   "imap"    "imaps"   "ldap"    "ldaps"   "mqtt"    "pop3"   
#> [15] "pop3s"   "rtmp"    "rtmpe"   "rtmps"   "rtmpt"   "rtmpte"  "rtmpts" 
#> [22] "rtsp"    "scp"     "sftp"    "smb"     "smbs"    "smtp"    "smtps"  
#> [29] "telnet"  "tftp"   
#> 
#> $ares
#> [1] ""
#> 
#> $ares_num
#> [1] 0
#> 
#> $libidn
#> [1] "2.3.7"
#>