[openssl/openssl] 986eda: INSTALL: document shared library pinning for stati...

[Matthias St. Pierre]

  Branch: refs/heads/openssl-3.1
  Home:   https://github.com/openssl/openssl
  Commit: 986eda314ef37d166c6f143282395fddba6dd33f
      https://github.com/openssl/openssl/commit/986eda314ef37d166c6f143282395fddba6dd33f
  Author: Matthias St. Pierre <matthias.st.pierre at ncp-e.com>
  Date:   2023-06-12 (Mon, 12 Jun 2023)

  Changed paths:
    M INSTALL.md

  Log Message:
  -----------
  INSTALL: document shared library pinning for static builds

The libcrypto library uses shared library pinning to prevent its
cleanup handlers from crashing at program termination because of a
premature unloading of the shared library.

However, shared library pinning is enabled also for static builds,
which may lead to surpising behaviour if libcrypto is linked
statically to a shared third-party library, because in this case
the third-party library gets pinned.

This surprising behaviour is caused by the fact that the `no-shared`
configure option does not imply `no-pinshared`. Since this quirk
can't be changed without potentially breaking existing code, we just
document it here and provide a workaround.

Fixes #20977

Reviewed-by: Todd Short <todd.short at me.com>
Reviewed-by: Tomas Mraz <tomas at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/20985)

(cherry picked from commit ce451fb86141fedad607bd68840639b06616047e)