ld.so.8: Describe $PLATFORM rpath token

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

1 files changed, 14 insertions, 7 deletions

diff --git a/man8/ld.so.8 b/man8/ld.so.8
index 10675ac5..41b371ec 100644
--- a/man8/ld.so.8
+++ b/man8/ld.so.8
@@ -120,14 +120,21 @@ depending on the architecture
 and
 on x86-32, it expands to
 .IR lib ).
+.TP
+.IR $PLATFORM " (or equivalently " ${PLATFORM} )
+This expands to a string corresponding to the processor type
+of the host system (e.g., "x86_64").
+On some architectures, the Linux kernel doesn't provide a platform
+string to the dynamic linker.
+The value of this string is taken from the
+.BR AT_PLATFORM
+value in the auxiliary vector (see
+.BR getauxval (3)).
+.\" To get an idea of the places that $PLATFORM would match,
+.\" look at the output of the following:
 .\"
-.\" There is also $PLATFORM.  This is a kind of wildcard
-.\" of directories related to AT_PLATFORM.  To get an idea of the
-.\" places that $PLATFORM would match, look at the output of the
-.\" following:
-.\"
-.\" mkdir /tmp/d
-.\" LD_LIBRARY_PATH=/tmp/d strace -e open /bin/date 2>&1 | grep /tmp/d
+.\"     mkdir /tmp/d
+.\"     LD_LIBRARY_PATH=/tmp/d strace -e open /bin/date 2>&1 | grep /tmp/d
 .\"
 .\" ld.so lets names be abbreviated, so $O will work for $ORIGIN;
 .\" Don't do this!!