From cd6dddf613db1922fa481efde9f64a22e49ef3b7 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 18 Apr 2008 20:38:02 +0000 Subject: [PATCH] Various wording improvements. --- man8/ld.so.8 | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/man8/ld.so.8 b/man8/ld.so.8 index 005de541d..f2916e22e 100644 --- a/man8/ld.so.8 +++ b/man8/ld.so.8 @@ -1,9 +1,9 @@ .\" This is in the public domain -.TH LD.SO 8 2007-05-31 "GNU" "Linux Programmer's Manual" +.TH LD.SO 8 2008-04-18 "GNU" "Linux Programmer's Manual" .SH NAME ld.so, ld-linux.so* \- dynamic linker/loader .SH SYNOPSIS -The dynamic linker can be run either indirectly through running some +The dynamic linker can be run either indirectly by running some dynamically linked program or library (in which case no command-line options to the dynamic linker can be passed and, in the ELF case, the dynamic linker which is stored in the @@ -41,9 +41,10 @@ and .IR /etc/ld.so.conf . .LP The shared libraries needed by the program are searched for -in various places: -.IP o -(ELF only) Using the DT_RPATH dynamic section attribute +in the following order: +.IP o 3 +(ELF only) Using the directories specified in the +DT_RPATH dynamic section attribute of the binary if present and DT_RUNPATH attribute does not exist. Use of DT_RPATH is deprecated. .IP o @@ -52,14 +53,15 @@ Using the environment variable Except if the executable is a set-user-ID/set-group-ID binary, in which case it is ignored. .IP o -(ELF only) Using the DT_RUNPATH dynamic section attribute +(ELF only) Using the directories specified in the +DT_RUNPATH dynamic section attribute of the binary if present. .IP o From the cache file .I /etc/ld.so.cache which contains a compiled list of candidate libraries previously found in the augmented library path. -If, however, the binary was linked with +If, however, the binary was linked with the .B \-z nodeflib linker option, libraries in the default library paths are skipped. .IP o @@ -67,7 +69,7 @@ In the default path .IR /lib , and then .IR /usr/lib . -If the binary was linked with +If the binary was linked with the .B \-z nodeflib linker option, this step is skipped. .SS $ORIGIN and rpath @@ -141,14 +143,15 @@ directories that are also set-user-ID will be loaded. .TP .B LD_BIND_NOW (libc5; glibc since 2.1.1) -If set to non-empty string, causes the dynamic linker to resolve all symbols -at program startup instead of deferring function call resolval to the point +If set to a non-empty string, +causes the dynamic linker to resolve all symbols +at program startup instead of deferring function call resolution to the point when they are first referenced. This is useful when using a debugger. .TP .B LD_TRACE_LOADED_OBJECTS (ELF only) -If set to non-empty string, causes the program to list its dynamic library +If set to a non-empty string, causes the program to list its dynamic library dependencies, as if run by .BR ldd (1), instead of running normally. @@ -158,7 +161,7 @@ many obsolete or only for internal use. .TP .B LD_WARN (ELF only)(glibc since 2.1.3) -If set to non-empty string, warn about unresolved symbols. +If set to a non-empty string, warn about unresolved symbols. .TP .B LD_NOWARN (a.out only)(libc5) @@ -190,7 +193,8 @@ is ignored for set-user-ID/set-group-ID binaries. .TP .B LD_VERBOSE (glibc since 2.1) -If set to non-empty string, output symbol versioning information about the +If set to a non-empty string, +output symbol versioning information about the program if querying information about the program (i.e. either .B LD_TRACE_LOADED_OBJECTS has been set, or