svn commit: r340769 - stable/12/usr.bin/ldd

[Mark Johnston]

Author: markj
Date: Thu Nov 22 16:52:30 2018
New Revision: 340769
URL: https://svnweb.freebsd.org/changeset/base/340769

Log:
  MFC r339653:
  Add an IMPLEMENTATION NOTES section to ldd.1.
  
  PR:	231926

Modified:
  stable/12/usr.bin/ldd/ldd.1
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/usr.bin/ldd/ldd.1
==============================================================================
--- stable/12/usr.bin/ldd/ldd.1	Thu Nov 22 16:27:30 2018	(r340768)
+++ stable/12/usr.bin/ldd/ldd.1	Thu Nov 22 16:52:30 2018	(r340769)
@@ -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