svn commit: r339653 - head/usr.bin/ldd

[Mark Johnston]

Author: markj
Date: Tue Oct 23 13:49:53 2018
New Revision: 339653
URL: https://svnweb.freebsd.org/changeset/base/339653

Log:
  Add an IMPLEMENTATION NOTES section to ldd.1.
  
  PR:		231926
  Reviewed by:	emaste
  MFC after:	1 month

Modified:
  head/usr.bin/ldd/ldd.1

Modified: head/usr.bin/ldd/ldd.1
==============================================================================
--- head/usr.bin/ldd/ldd.1	Tue Oct 23 13:44:33 2018	(r339652)
+++ head/usr.bin/ldd/ldd.1	Tue Oct 23 13:49:53 2018	(r339653)
@@ -1,6 +1,6 @@
 .\" $FreeBSD$
 .\"
-.Dd May 15, 2008
+.Dd October 23, 2018
 .Dt LDD 1
 .Os
 .Sh NAME
@@ -57,6 +57,14 @@ option displays a verbose listing of the dynamic linki
 encoded in the executable.
 See the source code and include
 files for the definitive meaning of all the fields.
+.Sh IMPLEMENTATION NOTES
+.Nm
+lists the dependencies of an executable by setting
+.Xr rtld 1
+environment variables and running the executable in a child process.
+If the executable is corrupt or invalid,
+.Nm
+may therefore fail without providing any diagnostic error messages.
 .Sh EXAMPLES
 The following is an example of a shell pipeline which uses the
 .Fl f
@@ -67,6 +75,7 @@ which link against libc.so.6:
 .Sh SEE ALSO
 .Xr ld 1 ,
 .Xr nm 1 ,
+.Xr readelf 1 ,
 .Xr rtld 1
 .Sh HISTORY
 A