- document LD_BIND_NOW

- new sentence, new line
- comment out comments

patch from (and ok) drahn@

1 files changed, 27 insertions, 15 deletions

diff --git a/libexec/ld.so/ld.so.1 b/libexec/ld.so/ld.so.1
index 57e2e2da956..143aae6eec2 100644
--- a/libexec/ld.so/ld.so.1
+++ b/libexec/ld.so/ld.so.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ld.so.1,v 1.3 2003/08/04 17:11:57 fgsch Exp $
+.\"	$OpenBSD: ld.so.1,v 1.4 2003/09/04 21:09:08 jmc Exp $
 .\"	$NetBSD: rtld.1,v 1.2 1995/10/08 23:43:28 pk Exp $
 .\"
 .\" Copyright (c) 1995 Paul Kranenburg
@@ -39,7 +39,8 @@
 .Nm
 is a self-contained, position independent program image providing run-time
 support for loading and link-editing shared objects into a process's
-address space. It uses the data structures
+address space.
+It uses the data structures
 .Po
 see
 .Xr link 5
@@ -53,16 +54,19 @@ system call.
 After all shared libraries have been successfully loaded,
 .Nm
 proceeds to resolve external references from both the main program and
-all objects loaded. A mechanism is provided for initialization routines
-to be called, on a per-object basis, giving a shared object an opportunity
+all objects loaded.
+A mechanism is provided for initialization routines to be called,
+on a per-object basis, giving a shared object an opportunity
 to perform any extra set-up, before execution of the program proper begins.
-
-<talk about CTORS/DTORS>
-
+.\"
+.\" <talk about CTORS/DTORS>
+.\"
 .Pp
 .Nm
-is itself a shared object that is initially loaded by the the kernel
-<How it is run>
+is itself a shared object that is initially loaded by the the kernel.
+.\"
+.\" <How it is run>
+.\"
 .Pp
 To quickly locate the required shared objects in the filesystem,
 .Nm
@@ -86,14 +90,21 @@ This variable is ignored for set-user-ID and set-group-ID executables.
 A colon separate list of library names to load before any of the regular
 libraries are loaded.
 This variable is ignored for set-user-ID and set-group-ID executables.
+.It Ev LD_BIND_NOW
+Specifies that the dynamic linker should process all relocations before
+transferring control to the program.
+Normally, the procedure linkage table entries are handled lazily,
+avoiding symbol lookup and relocation for unused functions.
+This variable is ignored for set-user-ID and set-group-ID executables.
 .It Ev LD_WARN_NON_PURE_CODE
 When set, issue a warning whenever a link-editing operation requires
-modification of the text segment of some loaded object. This is usually
-indicative of an incorrectly built library.
+modification of the text segment of some loaded object.
+This is usually indicative of an incorrectly built library.
 <not yet supported>
 .It Ev LD_SUPPRESS_WARNINGS
-When set, no warning messages of any kind are issued. Normally, a warning
-is given if satisfactorily versioned library could not be found.
+When set, no warning messages of any kind are issued.
+Normally, a warning is given if a satisfactorily versioned library
+could not be found.
 <not yet supported>
 .It Ev LD_TRACE_LOADED_OBJECTS
 When set, causes
@@ -117,7 +128,7 @@ The main program's name
 .Pq also known as Dq __progname .
 .It \&%A
 The value of the environment variable
-.Ev LD_TRACE_LOADED_OBJECTS_PROGNAME
+.Ev LD_TRACE_LOADED_OBJECTS_PROGNAME .
 <not yet supported>
 .It \&%o
 The library name.
@@ -152,7 +163,8 @@ This variable is ignored for set-user-ID and set-group-ID executables.
 .It Ev LD_NOSTD_PATH
 <not yet supported>
 When set, do not include a set of built-in standard directory paths for
-searching. This might be useful when running on a system with a completely
+searching.
+This might be useful when running on a system with a completely
 non-standard filesystem layout.
 .El
 .Sh FILES