Skip to content

Commit

Permalink
Add NOTES.UNIX, with a description on how to deal with runpaths
Browse files Browse the repository at this point in the history
[skip ci]

Reviewed-by: Rich Salz <rsalz@openssl.org>
(Merged from openssl#2818)
  • Loading branch information
levitte committed Mar 2, 2017
1 parent f8aa157 commit 45632ee
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 0 deletions.
1 change: 1 addition & 0 deletions INSTALL
Expand Up @@ -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)
Expand Down
30 changes: 30 additions & 0 deletions 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)'

0 comments on commit 45632ee

Please sign in to comment.