Skip to content

Commit 45632ee

Browse files
committed
Add NOTES.UNIX, with a description on how to deal with runpaths
[skip ci] Reviewed-by: Rich Salz <[email protected]> (Merged from openssl#2818)
1 parent f8aa157 commit 45632ee

File tree

2 files changed

+31
-0
lines changed

2 files changed

+31
-0
lines changed

INSTALL

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@
1818
For additional platform specific requirements, solutions to specific
1919
issues and other details, please read one of these:
2020

21+
* NOTES.UNIX (any supported Unix like system)
2122
* NOTES.VMS (OpenVMS)
2223
* NOTES.WIN (any supported Windows)
2324
* NOTES.DJGPP (DOS platform with DJGPP)

NOTES.UNIX

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
2+
NOTES FOR UNIX LIKE PLATFORMS
3+
=============================
4+
5+
For Unix/POSIX runtime systems on Windows, please see NOTES.WIN.
6+
7+
8+
Shared libraries and installation in non-standard locations
9+
-----------------------------------------------------------
10+
11+
Binaries on Unix variants expect to find shared libraries in standard
12+
locations, such as /usr/lib, /usr/local/lib and some other locations
13+
configured in the system (for example /etc/ld.so.conf on some systems).
14+
If the libraries are installed in non-standard locations, binaries
15+
will not find them and therefore fail to run unless they get a bit of
16+
help from a defined RPATH or RUNPATH. This can be applied by adding
17+
the appropriate linker flags to the configuration command, such as
18+
this (/usr/local/ssl was the default location for OpenSSL installation
19+
in versions before 1.1.0):
20+
21+
$ ./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl \
22+
-Wl,-rpath,/usr/local/ssl/lib
23+
24+
Because the actual library location may vary further (for example on
25+
multilib installations), there is a convenience variable in Makefile
26+
that holds the exact installation directory and that can be used like
27+
this:
28+
29+
$ ./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl \
30+
-Wl,-rpath,'$(LIBRPATH)'

0 commit comments

Comments
 (0)