The novice might wonder why programs need linking at run-time at all, so point out early on that the purpose of this exercise is linking against shared libraries that can be upgraded independently of the applications that use them (as contrasted with static linking). Wording taken from the Debian glibc package, 2003. Most readers today won't care about /lib/ld.so and a.out binaries, so move the passage describing that to the end of the description section. This way, it is more likely that the juicy bits (the overview and the library search path) will fit on the first page. Signed-off-by: Jonathan Nieder <jrnieder@xxxxxxxxx> --- man8/ld.so.8 | 39 +++++++++++++++++++-------------------- 1 files changed, 19 insertions(+), 20 deletions(-) diff --git a/man8/ld.so.8 b/man8/ld.so.8 index f0718dd..9fc96c9 100644 --- a/man8/ld.so.8 +++ b/man8/ld.so.8 @@ -21,6 +21,12 @@ and .B ld-linux.so* find and load the shared libraries needed by a program, prepare the program to run, and then run it. +Unless the +.B \-static +option was given to +.BR ld (1) +during compilation, all Linux programs are incomplete and require +further linking at run time. .LP The dynamic linker can be run either indirectly by running some dynamically linked program or library (in which case no command-line options @@ -33,26 +39,6 @@ section of the program is executed) or directly by running .I program .RI [ arguments ]\*(rq. .LP -Linux binaries require dynamic linking (linking at run time) -unless the -.B \-static -option was given to -.BR ld (1) -during compilation. -.LP -The program -.B ld.so -handles a.out binaries, a format used long ago; -.B ld-linux.so* -handles ELF (\fI/lib/ld-linux.so.1\fP for libc5, \fI/lib/ld-linux.so.2\fP -for glibc2), which everybody has been using for years now. -Otherwise both have the same behavior, and use the same -support files and programs -.BR ldd (1), -.BR ldconfig (8) -and -.IR /etc/ld.so.conf . -.LP The shared libraries needed by the program are searched for in the following order: .IP o 3 @@ -85,6 +71,19 @@ and then If the binary was linked with the .B \-z nodeflib linker option, this step is skipped. +.LP +The program +.B ld.so +handles a.out binaries, a format used long ago; +.B ld-linux.so* +handles ELF (\fI/lib/ld-linux.so.1\fP for libc5, \fI/lib/ld-linux.so.2\fP +for glibc2), which everybody has been using for years now. +Otherwise both have the same behavior, and use the same +support files and programs +.BR ldd (1), +.BR ldconfig (8) +and +.IR /etc/ld.so.conf . .SS $ORIGIN and rpath .PP .B ld.so -- 1.7.7 -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
