From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Sat, 17 Oct 2020 16:19:16 +0000 (+0200)
Subject: mallinfo.3: The 'usmblks' is nowadays always 0
X-Git-Tag: man-pages-5.09~152
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=70fd3c08d387343145b134a2d33d1808eff161f4;p=thirdparty%2Fman-pages.git

mallinfo.3: The 'usmblks' is nowadays always 0

Verified from the course code.

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

diff --git a/man3/mallinfo.3 b/man3/mallinfo.3
index 70cea83205..9ed04caa63 100644
--- a/man3/mallinfo.3
+++ b/man3/mallinfo.3
@@ -53,7 +53,7 @@ struct mallinfo {
     int smblks;    /* Number of free fastbin blocks */
     int hblks;     /* Number of mmapped regions */
     int hblkhd;    /* Space allocated in mmapped regions (bytes) */
-    int usmblks;   /* Maximum total allocated space (bytes) */
+    int usmblks;   /* See below */
     int fsmblks;   /* Space in freed fastbin blocks (bytes) */
     int uordblks;  /* Total allocated space (bytes) */
     int fordblks;  /* Total free space (bytes) */
@@ -92,9 +92,11 @@ The number of bytes in blocks currently allocated using
 .BR mmap (2).
 .TP
 .I usmblks
-The "highwater mark" for allocated space\(emthat is,
-the maximum amount of space that was ever allocated.
-This field is maintained only in nonthreading environments.
+This field is unused, and is always 0.
+.\" It seems to have been zero since at least as far back as glibc 2.15
+Historically, it was the "highwater mark" for allocated space\(emthat is,
+the maximum amount of space that was ever allocated (in bytes);
+this field was maintained only in nonthreading environments.
 .TP
 .I fsmblks
 The total number of bytes in fastbin free blocks.