[PATCH 3/6] ld.so.8: document LD_ASSUME_KERNEL

Jonathan Nieder
2011-10-20T07:09:07Z

From Aurelian Jarno's update to the Debian glibc package, r1812
(ld.so.8: Update the manpage, 2006-10-01). Presumably the text is
originally from the Red Hat document "What is LD_ASSUME_KERNEL and
what does it affect?", by Eric Paris and copyright © Red Hat Inc,
2004.
---
Eric, is it ok to include this text in the (public domain) ld.so.8
manpage?

To be safe, I'm withholding my sign-off for now, but I'm hoping it
should be ok.

man8/ld.so.8 | 12 ++++++++++++
1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/man8/ld.so.8 b/man8/ld.so.8
index 9fc96c9..6b5799b 100644
--- a/man8/ld.so.8
+++ b/man8/ld.so.8
@@ -190,6 +190,18 @@ for a.out binaries only.
Old versions of ld\-linux.so.1 also supported
.BR LD_ELF_PRELOAD .
.TP
+.B LD_ASSUME_KERNEL
+(glibc since 2.2.3)
+Every DSO (Dynamic Shared Object, aka shared library) can tell the dynamic linker in glibc which
+minimum OS ABI version is needed. The information about the minimum OS ABI version is encoded in
+a ELF note section usually named .note.ABI-tag. This is used to determine which library to load
+when multiple version of the same library is installed on the system.
+
+The
+.B LD_ASSUME_KERNEL
+environment variable overrides the kernel version used by the dynamic linker to determine which
+library to load.
+.TP
.B LD_AUDIT
(glibc since 2.4)
A colon-separated list of user-specified, ELF shared objects
--
1.7.7