| 1 |
\name{curlVersion} |
| 2 |
\alias{curlVersion} |
| 3 |
\title{Information describing the Curl library} |
| 4 |
\description{ |
| 5 |
This function queries the Curl library to provide information |
| 6 |
about its characteristics when it was compiled. |
| 7 |
This tells the user about its capabilities and can be used |
| 8 |
to determine strategies. |
| 9 |
} |
| 10 |
\usage{ |
| 11 |
curlVersion(id = 0) |
| 12 |
} |
| 13 |
\arguments{ |
| 14 |
\item{id}{an integer value between 0 and 3 inclusive. |
| 15 |
The idea is that one specifies the identifier for the version of |
| 16 |
interest. |
| 17 |
In fact, all values seem to yield the same result. |
| 18 |
} |
| 19 |
} |
| 20 |
\value{ |
| 21 |
A list |
| 22 |
\item{age}{integer giving the number of this libcurl, 0 is FIRST, 1 is |
| 23 |
SECOND, 2 is THIRD} |
| 24 |
\item{version}{the version identifier as a string, e.g. \code{"7.12.0"}} |
| 25 |
\item{version_num}{the value as an integer} |
| 26 |
\item{host}{the machine on which the libcurl was configured/built.} |
| 27 |
\item{features}{a named integer vector of bits indicating what |
| 28 |
features of libcurl were configured and built into this version. |
| 29 |
These are features such as |
| 30 |
ipv6, ssl, libz, largefile, ntlm (Microsoft "authorization").} |
| 31 |
\item{ssl_version}{the string identifying the SSL version.} |
| 32 |
\item{ssl_version_num}{the number identifying the SSL version} |
| 33 |
\item{libz_version}{the string identifying the version of libz.} |
| 34 |
\item{protocols}{a character vector of the supported HTTP protocols, |
| 35 |
e.g. http, https, ftp, ldap, gopher, telnet} |
| 36 |
\item{ares}{name of the asynchronous DNS (domain name service) lookup |
| 37 |
library. This is often simply the empty string indicating it is not there. |
| 38 |
} |
| 39 |
\item{ares_num}{the number for the ares library} |
| 40 |
\item{libidn}{the name of the IDN (internationalized domain names) |
| 41 |
library being used. This field only appears in version 3 of libcurl. |
| 42 |
If you are using version 2 (e.g. curl-7.11.2), this will be |
| 43 |
\code{NA}. |
| 44 |
An empty string indicates that the field is present, but has no value. |
| 45 |
} |
| 46 |
|
| 47 |
See the man page for \code{curl_version_info} |
| 48 |
for a description of these fields. |
| 49 |
\code{features} in R is a named integer vector |
| 50 |
detailing the different features. |
| 51 |
} |
| 52 |
\references{Curl homepage \url{https://curl.se/}} |
| 53 |
\author{Duncan Temple Lang} |
| 54 |
|
| 55 |
\seealso{ |
| 56 |
\code{curl_version_info} in the libcurl documentation. |
| 57 |
} |
| 58 |
\examples{ |
| 59 |
curlVersion() |
| 60 |
} |
| 61 |
\keyword{IO} |
| 62 |
\concept{reflectance} |