xref: /minix3/crypto/external/bsd/openssl/dist/doc/openssl-shared.txt (revision ebfedea0ce5bbe81e252ddf32d732e40fb633fae)
1*ebfedea0SLionel SambucThe OpenSSL  shared libraries are often installed in a directory like
2*ebfedea0SLionel Sambuc/usr/local/ssl/lib.
3*ebfedea0SLionel Sambuc
4*ebfedea0SLionel SambucIf this directory is not in a standard system path for dynamic/shared
5*ebfedea0SLionel Sambuclibraries, then you will have problems linking and executing
6*ebfedea0SLionel Sambucapplications that use OpenSSL libraries UNLESS:
7*ebfedea0SLionel Sambuc
8*ebfedea0SLionel Sambuc* you link with static (archive) libraries.  If you are truly
9*ebfedea0SLionel Sambuc  paranoid about security, you should use static libraries.
10*ebfedea0SLionel Sambuc* you use the GNU libtool code during linking
11*ebfedea0SLionel Sambuc  (http://www.gnu.org/software/libtool/libtool.html)
12*ebfedea0SLionel Sambuc* you use pkg-config during linking (this requires that
13*ebfedea0SLionel Sambuc  PKG_CONFIG_PATH includes the path to the OpenSSL shared
14*ebfedea0SLionel Sambuc  library directory), and make use of -R or -rpath.
15*ebfedea0SLionel Sambuc  (http://www.freedesktop.org/software/pkgconfig/)
16*ebfedea0SLionel Sambuc* you specify the system-wide link path via a command such
17*ebfedea0SLionel Sambuc  as crle(1) on Solaris systems.
18*ebfedea0SLionel Sambuc* you add the OpenSSL shared library directory to /etc/ld.so.conf
19*ebfedea0SLionel Sambuc  and run ldconfig(8) on Linux systems.
20*ebfedea0SLionel Sambuc* you define the LD_LIBRARY_PATH, LIBPATH, SHLIB_PATH (HP),
21*ebfedea0SLionel Sambuc  DYLD_LIBRARY_PATH (MacOS X) or PATH (Cygwin and DJGPP)
22*ebfedea0SLionel Sambuc  environment variable and add the OpenSSL shared library
23*ebfedea0SLionel Sambuc  directory to it.
24*ebfedea0SLionel Sambuc
25*ebfedea0SLionel SambucOne common tool to check the dynamic dependencies of an executable
26*ebfedea0SLionel Sambucor dynamic library is ldd(1) on most UNIX systems.
27*ebfedea0SLionel Sambuc
28*ebfedea0SLionel SambucSee any operating system documentation and manpages about shared
29*ebfedea0SLionel Sambuclibraries for your version of UNIX.  The following manpages may be
30*ebfedea0SLionel Sambuchelpful: ld(1), ld.so(1), ld.so.1(1) [Solaris], dld.sl(1) [HP],
31*ebfedea0SLionel Sambucldd(1), crle(1) [Solaris], pldd(1) [Solaris], ldconfig(8) [Linux],
32*ebfedea0SLionel Sambucchatr(1) [HP].
33