aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorSteven Fackler <[email protected]>2017-08-11 22:44:46 -0700
committerGitHub <[email protected]>2017-08-11 22:44:46 -0700
commit75d927b2bd2c3d6ad72dcf325e921ff6c916ccf6 (patch)
treebcc5e5421d882d35dd69517f124019e888c8e928 /README.md
parentRelease v0.9.16 (diff)
parentmsvc/vcpkg dynamic builds now require explicit opt-in (diff)
downloadrust-openssl-75d927b2bd2c3d6ad72dcf325e921ff6c916ccf6.tar.xz
rust-openssl-75d927b2bd2c3d6ad72dcf325e921ff6c916ccf6.zip
Merge pull request #622 from mcgoo/vcpkg
try to find openssl libraries in a vcpkg ports tree
Diffstat (limited to 'README.md')
-rw-r--r--README.md25
1 files changed, 23 insertions, 2 deletions
diff --git a/README.md b/README.md
index 32ae89bd..2383fead 100644
--- a/README.md
+++ b/README.md
@@ -70,7 +70,11 @@ automatically detected.
### Windows MSVC
-On MSVC it's unfortunately not always a trivial process acquiring OpenSSL.
+On MSVC it's unfortunately not always a trivial process acquiring OpenSSL. A couple of possibilities
+are downloading precompiled binaries for OpenSSL 1.1.0, or installing OpenSSL 1.0.2 using vcpkg.
+
+#### Installing OpenSSL 1.1.0 using precompiiled binaries
+
Perhaps the easiest way to do this right now is to download [precompiled
binaries] and install them on your system. Currently it's recommended to
install the 1.1.0 (non-light) installation if you're choosing this route.
@@ -84,7 +88,24 @@ installation via an environment variable:
set OPENSSL_DIR=C:\OpenSSL-Win64
```
-Note that this OpenSSL distribution does not ship with any root certificates.
+Now you will need to [install root certificates.](#acquiring-root-certificates)
+
+#### Installing OpenSSL 1.0.2 using vcpkg
+
+Install [vcpkg](https://github.com/Microsoft/vcpkg), and install the OpenSSL port like this:
+
+```Batchfile
+vcpkg install openssl:x64-windows
+set VCPKG_ROOT=c:\path\to\vcpkg\installation
+cargo build
+```
+
+For more information see the vcpkg build helper [documentation](http://docs.rs/vcpkg).
+To finsh setting up OpenSSL you will need to [install root certificates.](#acquiring-root-certificates)
+
+#### Acquiring Root Certificates
+
+Neither of the above OpenSSL distributions ship with any root certificates.
So to make requests to servers on the internet, you have to install them
manually. Download the [cacert.pem file from here], copy it somewhere safe
(`C:\OpenSSL-Win64\certs` is a good place) and point the `SSL_CERT_FILE`