]>
Commit | Line | Data |
---|---|---|
f170e1cc | 1 | .\" Copyright (c) 2013, Peter Schiffer <pschiffe@redhat.com> |
16e05f30 PS |
2 | .\" |
3 | .\" %%%LICENSE_START(GPLv2+_DOC_FULL) | |
4 | .\" This is free documentation; you can redistribute it and/or | |
5 | .\" modify it under the terms of the GNU General Public License as | |
6 | .\" published by the Free Software Foundation; either version 2 of | |
7 | .\" the License, or (at your option) any later version. | |
8 | .\" | |
9 | .\" The GNU General Public License's references to "object code" | |
10 | .\" and "executables" are to be interpreted as the output of any | |
11 | .\" document formatting or typesetting system, including | |
12 | .\" intermediate and printed output. | |
13 | .\" | |
14 | .\" This manual is distributed in the hope that it will be useful, | |
15 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 | .\" GNU General Public License for more details. | |
18 | .\" | |
19 | .\" You should have received a copy of the GNU General Public | |
20 | .\" License along with this manual; if not, see | |
21 | .\" <http://www.gnu.org/licenses/>. | |
22 | .\" %%%LICENSE_END | |
b8efb414 | 23 | .TH MEMUSAGESTAT 1 2016-10-08 "GNU" "Linux programmer's manual" |
16e05f30 PS |
24 | .SH NAME |
25 | memusagestat \- generate graphic from memory profiling data | |
26 | .SH SYNOPSIS | |
27 | .BR memusagestat " [\fIoption\fR]... \fIdatafile\fR [\fIoutfile\fR]" | |
28 | .SH DESCRIPTION | |
29 | .B memusagestat | |
a863cb3a MK |
30 | creates a PNG file containing a graphical representation of the |
31 | memory profiling data in the file | |
32 | .IR datafile ; | |
33 | that file is generated via the | |
34 | .I -d | |
35 | (or | |
36 | .IR --data ) | |
37 | option of | |
38 | .BR memusage (1). | |
39 | ||
40 | The red line in the graph shows the heap usage (allocated memory) | |
41 | and the green line shows the stack usage. | |
42 | The x-scale is either the number of memory-handling function calls or | |
43 | (if the | |
44 | .I -t | |
45 | option is specified) | |
46 | time. | |
16e05f30 PS |
47 | .SH OPTIONS |
48 | .TP | |
49 | .BI \-o\ file \fR,\ \fB\-\-output= file | |
50 | Name of the output file. | |
51 | .TP | |
52 | .BI \-s\ string \fR,\ \fB\-\-string= string | |
a863cb3a MK |
53 | Use |
54 | .I string | |
55 | as the title inside the output graph. | |
16e05f30 PS |
56 | .TP |
57 | .BI \-t\fR,\ \fB\-\-time | |
a863cb3a | 58 | Use time (rather than number of function calls) as the scale for the X axis. |
16e05f30 PS |
59 | .TP |
60 | .BI \-T\fR,\ \fB\-\-total | |
a863cb3a | 61 | Also draw a graph of total memory consumption. |
16e05f30 PS |
62 | .TP |
63 | .BI \-x\ size \fR,\ \fB\-\-x-size= size | |
a863cb3a MK |
64 | Make the output graph |
65 | .I size | |
66 | pixels wide. | |
16e05f30 PS |
67 | .TP |
68 | .BI \-y\ size \fR,\ \fB\-\-y\-size= size | |
a863cb3a MK |
69 | Make the output graph |
70 | .I size | |
71 | pixels high. | |
16e05f30 PS |
72 | .TP |
73 | .BI \-?\fR,\ \fB\-\-help | |
a863cb3a | 74 | Print a help message and exit. |
16e05f30 PS |
75 | .TP |
76 | .BI \fB\-\-usage | |
77 | Print a short usage message and exit. | |
78 | .TP | |
79 | .BI \-V\fR,\ \fB\-\-version | |
80 | Print version information and exit. | |
16e05f30 | 81 | .SH BUGS |
a863cb3a MK |
82 | To report bugs, see |
83 | .UR http://www.gnu.org/software/libc/bugs.html | |
84 | .UE | |
f2ae94cd MK |
85 | .SH EXAMPLE |
86 | See | |
87 | .BR memusage (1). | |
16e05f30 | 88 | .SH SEE ALSO |
a863cb3a MK |
89 | .BR memusage (1), |
90 | .BR mtrace (1) |