diff --git a/man1/memusage.1 b/man1/memusage.1 index 30182cee2..413dff3a1 100644 --- a/man1/memusage.1 +++ b/man1/memusage.1 @@ -74,10 +74,12 @@ calls, and sum of \fIlength\fR arguments of all .BR mmap (2) calls. -In a case of realloc, respectively mremap, if a new size of an original -malloc, -respectively mremap call is bigger than an old one, -sum of all such differences (new size - old size) is added. +In the case of +.BR realloc (3) +and +.BR mremap (2), +if the new size of an allocation is larger than the previous size, +the sum of all such differences (new size minus old size) is added. .TP .B "heap peak" Maximum of all \fIsize\fR arguments of @@ -101,13 +103,18 @@ the difference from the base stack pointer computed. The maximum of these differences is then the stack peak. .RE .PP -If +Immediately following this summary line, a table shows the number calls, +total memory allocated or deallocated, +and number of failed calls for each intercepted function. + +The "realloc/total memory" of the table output by +.B memusage +does not reflect cases where .BR realloc (3) is used to reallocate a block of memory -to have a smaller size than previously, -total memory of realloc cell is not updated. -This can cause sum of all cells (excluding free) of total memory being -greater than free cell. +to have a smaller size than previously. +This can cause sum of all "total memory" cells (excluding "free") +to be larger than the "free/total memory" cell. .SS Histogram for block sizes The "Histogram for block sizes" provides a breakdown of memory allocations into various bucket sizes.