summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorbartonjs <jbarton@microsoft.com>2016-09-26 09:39:58 -0700
committerbartonjs <jbarton@microsoft.com>2016-09-26 09:39:58 -0700
commit3acc1bf985e7bf4c038df1c68ac5c941954eafca (patch)
treedb0e0f118da88fad773be37e5b43d0e75cf7f1ab /Documentation
parent712cdd405e9aac7fc6806814a2fddd976e84d9df (diff)
downloadcoreclr-3acc1bf985e7bf4c038df1c68ac5c941954eafca.tar.gz
coreclr-3acc1bf985e7bf4c038df1c68ac5c941954eafca.tar.bz2
coreclr-3acc1bf985e7bf4c038df1c68ac5c941954eafca.zip
Fix stale OSX getting started to stop using `brew link`
Even with --force the `brew link` command will not link openssl any longer. This updates the instructions to provide a less invasive version of what we needed `brew link` to do: make the runtime versioned ABI resolvable, and make the header files discoverable (via pkg-config).
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/building/osx-instructions.md20
1 files changed, 19 insertions, 1 deletions
diff --git a/Documentation/building/osx-instructions.md b/Documentation/building/osx-instructions.md
index 6d3469b2d9..9e6b913675 100644
--- a/Documentation/building/osx-instructions.md
+++ b/Documentation/building/osx-instructions.md
@@ -51,7 +51,25 @@ The CoreFX cryptography libraries are built on OpenSSL. The version of OpenSSL i
```sh
brew install openssl
-brew link --force openssl
+
+# We need to make the runtime libraries discoverable, as well as make
+# pkg-config be able to find the headers and current ABI version.
+#
+# Ensure the paths we will need exist
+mkdir -p /usr/local/lib/pkgconfig
+
+# The rest of these instructions assume a default Homebrew path of
+# /usr/local/opt/<module>, with /usr/local being the answer to
+# `brew --prefix`.
+#
+# Runtime dependencies
+ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
+ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/
+
+# Compile-time dependences (for pkg-config)
+ln -s /usr/local/opt/openssl/lib/pkgconfig/libcrypto.pc /usr/local/lib/pkgconfig/
+ln -s /usr/local/opt/openssl/lib/pkgconfig/libssl.pc /usr/local/lib/pkgconfig/
+ln -s /usr/local/opt/openssl/lib/pkgconfig/openssl.pc /usr/local/lib/pkgconfig/
```
Build the Runtime and Microsoft Core Library