mallinfo.3: Further discourage use of mallinfo()

The BUGS section already explains why you need to be cautious
about using mallinfo, but given the number of bug reports we see
on Android, it seems not many people are reading that far. Call it
out up front.

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

diff --git a/man3/mallinfo.3 b/man3/mallinfo.3
index 0cf773882a69266360591b3326ce8adb4d5426d4..677a9a1cfd8a17d46160d8b3ae28f55b4c1450bb 100644 (file)
--- a/man3/mallinfo.3
+++ b/man3/mallinfo.3
@@ -37,7 +37,14 @@ function returns a copy of a structure containing information about
 memory allocations performed by
 .BR malloc (3)
 and related functions.
-This structure is defined as follows:
+.PP
+Note that not all allocations are visible to
+.BR mallinfo ();
+see BUGS and consider using
+.BR malloc_info (3)
+instead.
+.PP
+The returned structure is defined as follows:
 .PP
 .in +4n
 .EX