| 1 |
.\" Copyright 2013, Peter Schiffer <[email protected]> |
| 2 |
.\" Copyright, the authors of the Linux man-pages project |
| 3 |
.\" |
| 4 |
.\" SPDX-License-Identifier: GPL-2.0-or-later |
| 5 |
.\" |
| 6 |
.TH memusagestat 1 2026-02-08 "Linux man-pages 6.18" |
| 7 |
.SH NAME |
| 8 |
memusagestat \- generate graphic from memory profiling data |
| 9 |
.SH SYNOPSIS |
| 10 |
.SY memusagestat |
| 11 |
.RI [ option \~.\|.\|.\&] |
| 12 |
.I datafile |
| 13 |
.RI [ outfile ] |
| 14 |
.YS |
| 15 |
.SH DESCRIPTION |
| 16 |
.B memusagestat |
| 17 |
creates a PNG file containing a graphical representation of the |
| 18 |
memory profiling data in the file |
| 19 |
.IR datafile ; |
| 20 |
that file is generated via the |
| 21 |
.I \-d |
| 22 |
(or |
| 23 |
.IR \-\-data ) |
| 24 |
option of |
| 25 |
.BR memusage (1). |
| 26 |
.P |
| 27 |
The red line in the graph shows the heap usage (allocated memory) |
| 28 |
and the green line shows the stack usage. |
| 29 |
The x-scale is either the number of memory-handling function calls or |
| 30 |
(if the |
| 31 |
.I \-t |
| 32 |
option is specified) |
| 33 |
time. |
| 34 |
.SH OPTIONS |
| 35 |
.TP |
| 36 |
.BI \-o\~ file |
| 37 |
.TQ |
| 38 |
.BI \-\-output= file |
| 39 |
Name of the output file. |
| 40 |
.TP |
| 41 |
.BI \-s\~ string |
| 42 |
.TQ |
| 43 |
.BI \-\-string= string |
| 44 |
Use |
| 45 |
.I string |
| 46 |
as the title inside the output graph. |
| 47 |
.TP |
| 48 |
.B \-t |
| 49 |
.TQ |
| 50 |
.B \-\-time |
| 51 |
Use time (rather than number of function calls) as the scale for the X axis. |
| 52 |
.TP |
| 53 |
.B \-T |
| 54 |
.TQ |
| 55 |
.B \-\-total |
| 56 |
Also draw a graph of total memory consumption. |
| 57 |
.TP |
| 58 |
.BI \-x\~ size |
| 59 |
.TQ |
| 60 |
.BI \-\-x\-size= size |
| 61 |
Make the output graph |
| 62 |
.I size |
| 63 |
pixels wide. |
| 64 |
.TP |
| 65 |
.BI \-y\~ size |
| 66 |
.TQ |
| 67 |
.BI \-\-y\-size= size |
| 68 |
Make the output graph |
| 69 |
.I size |
| 70 |
pixels high. |
| 71 |
.TP |
| 72 |
.B \-? |
| 73 |
.TQ |
| 74 |
.B \-\-help |
| 75 |
Print a help message and exit. |
| 76 |
.TP |
| 77 |
.B \-\-usage |
| 78 |
Print a short usage message and exit. |
| 79 |
.TP |
| 80 |
.B \-V |
| 81 |
.TQ |
| 82 |
.B \-\-version |
| 83 |
Print version information and exit. |
| 84 |
.SH BUGS |
| 85 |
To report bugs, see |
| 86 |
.UR http:\://www.gnu.org/software/libc/bugs.html |
| 87 |
.UE |
| 88 |
.SH EXAMPLES |
| 89 |
See |
| 90 |
.BR memusage (1). |
| 91 |
.SH SEE ALSO |
| 92 |
.BR memusage (1), |
| 93 |
.BR mtrace (1) |