aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLasse Collin <lasse.collin@tukaani.org>2024-03-15 17:43:39 +0200
committerLasse Collin <lasse.collin@tukaani.org>2024-03-15 18:04:10 +0200
commit8a25ba024d55610c448c6e4f1400a00bae51b493 (patch)
tree894e46e2b679f11d5fc0de635560bb591629a89b
parentBuild: Use only the generic symbol versioning with NVIDIA HPC Compiler. (diff)
downloadxz-8a25ba024d55610c448c6e4f1400a00bae51b493.tar.xz
INSTALL: Document arguments of --enable-symbol-versions.
-rw-r--r--INSTALL43
1 files changed, 39 insertions, 4 deletions
diff --git a/INSTALL b/INSTALL
index 624a1079..6a990ef2 100644
--- a/INSTALL
+++ b/INSTALL
@@ -561,10 +561,45 @@ XZ Utils Installation
sandboxing. If no Landlock support
is found, configure will give an error.
- --enable-symbol-versions
- Use symbol versioning for liblzma. This is enabled by
- default on GNU/Linux, other GNU-based systems, and
- FreeBSD.
+ --enable-symbol-versions[=VARIANT]
+ Use symbol versioning for liblzma shared library.
+ This is enabled by default on GNU/Linux (glibc only),
+ other GNU-based systems, and FreeBSD.
+
+ Symbol versioning is never used for static liblzma. This
+ option is ignored when not building a shared library.
+
+ Supported VARIANTs:
+
+ no Disable symbol versioning. This is the
+ same as using --disable-symbol-versions.
+
+ auto Autodetect between "no", "linux",
+ and "generic".
+
+ yes Autodetect between "linux" and
+ "generic". This forces symbol
+ versioning to be used when
+ building a shared library.
+
+ generic Generic version is the default for
+ FreeBSD and GNU/Linux on MicroBlaze.
+
+ This is also used on GNU/Linux when
+ building with NVIDIA HPC Compiler
+ because the compiler doesn't support
+ the features required for the "linux"
+ variant below.
+
+ linux Special version for GNU/Linux (glibc
+ only). This adds a few extra symbol
+ versions for compatibility with binaries
+ that have been linked against a liblzma
+ version that has been patched with
+ "xz-5.2.2-compat-libs.patch" from
+ RHEL/CentOS 7. That patch was used
+ by some build tools outside of
+ RHEL/CentOS 7 too.
--enable-debug
This enables the assert() macro and possibly some other