From 5d704fafcbe60a52dc0e741a28e1b5219ad24337 Mon Sep 17 00:00:00 2001
From: Mark Johnston <markj@FreeBSD.org>
Date: Tue, 23 Oct 2018 13:49:53 +0000
Subject: [PATCH] Add an IMPLEMENTATION NOTES section to ldd.1.

PR:		231926
Reviewed by:	emaste
MFC after:	1 month
---
 usr.bin/ldd/ldd.1 | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/usr.bin/ldd/ldd.1 b/usr.bin/ldd/ldd.1
index 5a06515ebd87..2a90d5ac537d 100644
--- a/usr.bin/ldd/ldd.1
+++ b/usr.bin/ldd/ldd.1
@@ -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 linking headers
 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