diff options
author | Richard Levitte <levitte@openssl.org> | 2017-03-01 23:43:03 +0100 |
---|---|---|
committer | Richard Levitte <levitte@openssl.org> | 2017-03-02 07:34:13 +0100 |
commit | 41371618f72b93bdf3e0a4be369e4df6b65334cd (patch) | |
tree | e99e667df170eb73be0112681bfacec54d804085 /NOTES.UNIX | |
parent | 4cdf91ef7d6cd05706027c341d36db867276ea47 (diff) |
Add NOTES.UNIX, with a description on how to deal with runpaths
[skip ci]
Reviewed-by: Rich Salz <rsalz@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/2818)
(cherry picked from commit 45632ee3bb7ab4ed405d5251d76dd5b94d782adb)
Diffstat (limited to 'NOTES.UNIX')
-rw-r--r-- | NOTES.UNIX | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/NOTES.UNIX b/NOTES.UNIX new file mode 100644 index 0000000000..43146e9ed0 --- /dev/null +++ b/NOTES.UNIX @@ -0,0 +1,30 @@ + + NOTES FOR UNIX LIKE PLATFORMS + ============================= + + For Unix/POSIX runtime systems on Windows, please see NOTES.WIN. + + + Shared libraries and installation in non-standard locations + ----------------------------------------------------------- + + Binaries on Unix variants expect to find shared libraries in standard + locations, such as /usr/lib, /usr/local/lib and some other locations + configured in the system (for example /etc/ld.so.conf on some systems). + If the libraries are installed in non-standard locations, binaries + will not find them and therefore fail to run unless they get a bit of + help from a defined RPATH or RUNPATH. This can be applied by adding + the appropriate linker flags to the configuration command, such as + this (/usr/local/ssl was the default location for OpenSSL installation + in versions before 1.1.0): + + $ ./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl \ + -Wl,-rpath,/usr/local/ssl/lib + + Because the actual library location may vary further (for example on + multilib installations), there is a convenience variable in Makefile + that holds the exact installation directory and that can be used like + this: + + $ ./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl \ + -Wl,-rpath,'$(LIBRPATH)' |