dl_iterate_phdr.3: Note that 'size' allows callback() to discover structure extensions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3
index 4cbebd824ab839478564fdedbfcfc3bfe1828833..d91d0ecd3d5cd86c971df86ca40aa768559ca6b6 100644 (file)
--- a/man3/dl_iterate_phdr.3
+++ b/man3/dl_iterate_phdr.3
@@ -171,6 +171,13 @@ T} Thread safety   MT-Safe
 The
 .BR dl_iterate_phdr ()
 function is Linux-specific and should be avoided in portable applications.
+.SH NOTES
+Future versions of the C library may add further fields to the
+.IR dl_phdr_info
+structure; in that event, the
+.I size
+argument provides a mechanism for the callback function to discover
+whether it is running on a system with added fields.
 .SH EXAMPLE
 The following program displays a list of pathnames of the
 shared objects it has loaded.