[openssl-commits] [openssl] master update

[Richard Levitte]

The branch master has been updated
       via  45632ee3bb7ab4ed405d5251d76dd5b94d782adb (commit)
      from  f8aa15728ba960137faf77b298fa60c1e63dc50f (commit)


- Log -----------------------------------------------------------------
commit 45632ee3bb7ab4ed405d5251d76dd5b94d782adb
Author: Richard Levitte <levitte at openssl.org>
Date:   Wed Mar 1 23:43:03 2017 +0100

    Add NOTES.UNIX, with a description on how to deal with runpaths
    
    [skip ci]
    
    Reviewed-by: Rich Salz <rsalz at openssl.org>
    (Merged from https://github.com/openssl/openssl/pull/2818)

-----------------------------------------------------------------------

Summary of changes:
 INSTALL    |  1 +
 NOTES.UNIX | 30 ++++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 NOTES.UNIX

diff --git a/INSTALL b/INSTALL
index 26cbe30..64055ac 100644
--- a/INSTALL
+++ b/INSTALL
@@ -18,6 +18,7 @@
  For additional platform specific requirements, solutions to specific
  issues and other details, please read one of these:
 
+  * NOTES.UNIX (any supported Unix like system)
   * NOTES.VMS (OpenVMS)
   * NOTES.WIN (any supported Windows)
   * NOTES.DJGPP (DOS platform with DJGPP)
diff --git a/NOTES.UNIX b/NOTES.UNIX
new file mode 100644
index 0000000..43146e9
--- /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)'