The R Project SVN R

Rev

Rev 70779 | Rev 79670 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 70779 Rev 73771
Line 1... Line 1...
1 
% File src/library/base/man/curlVersion.Rd
 1 
% File src/library/base/man/curlVersion.Rd
2 
% Part of the R package, https://www.R-project.org
 2 
% Part of the R package, https://www.R-project.org
3 
% Copyright 2015 R Core Team
 3 
% Copyright 2015-2017 R Core Team
4 
% Distributed under GPL 2 or later
 4 
% Distributed under GPL 2 or later
5 
 
 5 
 
6 
\name{libcurlVersion}
 6 
\name{libcurlVersion}
7 
\alias{libcurlVersion}
 7 
\alias{libcurlVersion}
8 
\title{
 8 
\title{
Line 16... Line 16...
16 
}
 16 
}
17 
\value{
 17 
\value{
18 
  A character string, with value the \code{libcurl} version in use or
 18 
  A character string, with value the \code{libcurl} version in use or
19 
  \code{""} if none is.  If \code{libcurl} is available, has attributes
 19 
  \code{""} if none is.  If \code{libcurl} is available, has attributes
20 
 
 20 
 
21 
  \item{ssl_version}{A character string naming the SSL implementation
 21 
  \item{ssl_version}{A character string naming the SSL/TLS implementation
22 
    and version, possibly \code{"none"}.  It is intended for the version
 22 
    and version, possibly \code{"none"}.  It is intended for the version
23 
    of OpenSSL used, but not all implementations of \code{libcurl} use
 23 
    of OpenSSL used, but not all implementations of \code{libcurl} use
24 
    OpenSSL --- for example macOS reports \code{"SecureTranspart"}, its
 24 
    OpenSSL --- for example macOS reports \code{"SecureTranspart"}, its
25 
    wrapper for SSL/TLS.}
 25 
    wrapper for SSL/TLS.}
26 
 
 26 
 
Line 30... Line 30...
30 
    something like \code{"libssh2/1.5.0"}.}
 30 
    something like \code{"libssh2/1.5.0"}.}
31 
 
 31 
 
32 
  \item{protocols}{A character vector of the names of supported
 32 
  \item{protocols}{A character vector of the names of supported
33 
    protocols, also known as \sQuote{schemes} when part of a URL.}
 33 
    protocols, also known as \sQuote{schemes} when part of a URL.}
34 
}
 34 
}
- 
 
 35 
\section{Warning}{
- 
 
 36 
  In late 2017 a \code{libcurl} installation was seen divided into two
- 
 
 37 
  libraries, \code{libcurl} and \code{libcurl-feature}, and the first
- 
 
 38 
  had been updated but not the second.  As the compiled function
- 
 
 39 
  recording the version was in the latter, the version reported by
- 
 
 40 
  \code{libcurlVersion} was misleading.
- 
 
 41 
}
35 
\seealso{
 42 
\seealso{
36 
  \code{\link{extSoftVersion}} for versions of other third-party
 43 
  \code{\link{extSoftVersion}} for versions of other third-party
37 
  software.
 44 
  software.
38 
 
 45 
 
39 
  \code{\link{curlGetHeaders}}, \code{\link{download.file}} and
 46 
  \code{\link{curlGetHeaders}}, \code{\link{download.file}} and
40 
  \code{\link{url}} for functions which (optionally) use \code{libcurl}.
 47 
  \code{\link{url}} for functions which (optionally) use \code{libcurl}.
41 
 
 48 
 
42 
  \url{http://curl.haxx.se/docs/sslcerts.html} and
 49 
  \url{http://curl.haxx.se/docs/sslcerts.html} and
43 
  \url{http://curl.haxx.se/docs/ssl-compared.html} for more details on
 50 
  \url{http://curl.haxx.se/docs/ssl-compared.html} for more details on
44 
  SSL versions.  Normally \code{libcurl} used with \R uses
 51 
  SSL versions (the current standard being known as TLS).  Normally
45 
  SecureTransport on macOS, OpenSSL on Windows and GnuTLS, NSS or OpenSSL
 52 
  \code{libcurl} used with \R uses SecureTransport on macOS, OpenSSL on
46 
  on Unix-alikes.  (At the time of writing Debian-based Linuxen use
 53 
  Windows and GnuTLS, NSS or OpenSSL on Unix-alikes.  (At the time of
47 
  GnuTLS, RedHat-based ones use NSS.)
 54 
  writing Debian-based Linuxen use GnuTLS and RedHat-based ones use NSS,
- 
 
 55 
  but it has been announced that Fedora 27 will switch to OpenSSL.)
48 
}
 56 
}
49 
\examples{
 57 
\examples{
50 
libcurlVersion()
 58 
libcurlVersion()
51 
}
 59 
}