>Number:         9663
>Category:       lib
>Synopsis:       LD_PRELOAD is not documented
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    lib-bug-people (Library Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Mar 23 00:33:01 2000
>Last-Modified:
>Originator:     John Hawkinson
>Organization:
	MIT
>Release:        NetBSD 1.4.2
>Environment:
	
System: NetBSD zorkmid.mit.edu 1.4.2 NetBSD 1.4.2 (ZORKMID) #1: Wed Mar 22 03:24:44 EST 2000 jhawk@zorkmid.mit.edu:/usr/src/sys/arch/i386/compile/ZORKMID i386


>Description:
	LD_PRELOAD is not documented. rtld(1) (d/b/a ld.so(1))
documents LD_LIBRARY_PATH and friends, but omits LD_PRELOAD.
LD_PRELOAD is terribly useful, especially for things like
malloc debugging, etc., and appears to be supported for both a.out
and ELF.

	Incdiently, the ld.so(1) page purports (in the headers)
to be rtld(1). This should probably be fixed.

>How-To-Repeat:
	Watch vi core dump in malloc() and try to debug it and see
	how many PRs you can generate along the way.
>Fix:
	Consider stealing wording (or paraphrasing) from Solaris'
ld.so.1(1).
>Audit-Trail:
>Unformatted: