2014-09-01 13:08:18 +00:00
|
|
|
.\" Copyright (c) 2013, Peter Schiffer <pschiffe@redhat.com>
|
2014-09-01 08:53:25 +00:00
|
|
|
.\"
|
|
|
|
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
|
|
|
|
.\" This is free documentation; you can redistribute it and/or
|
|
|
|
.\" modify it under the terms of the GNU General Public License as
|
|
|
|
.\" published by the Free Software Foundation; either version 2 of
|
|
|
|
.\" the License, or (at your option) any later version.
|
|
|
|
.\"
|
|
|
|
.\" The GNU General Public License's references to "object code"
|
|
|
|
.\" and "executables" are to be interpreted as the output of any
|
|
|
|
.\" document formatting or typesetting system, including
|
|
|
|
.\" intermediate and printed output.
|
|
|
|
.\"
|
|
|
|
.\" This manual is distributed in the hope that it will be useful,
|
|
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
.\" GNU General Public License for more details.
|
|
|
|
.\"
|
|
|
|
.\" You should have received a copy of the GNU General Public
|
|
|
|
.\" License along with this manual; if not, see
|
|
|
|
.\" <http://www.gnu.org/licenses/>.
|
|
|
|
.\" %%%LICENSE_END
|
memusage.1, memusagestat.1, pldd.1, accept.2, adjtimex.2, arch_prctl.2, bdflush.2, bpf.2, close.2, epoll_ctl.2, epoll_wait.2, execve.2, execveat.2, fanotify_init.2, fanotify_mark.2, fcntl.2, fsync.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getrandom.2, getrlimit.2, getrusage.2, getsid.2, getunwind.2, io_getevents.2, ioctl_fat.2, kexec_load.2, killpg.2, listxattr.2, lseek.2, madvise.2, memfd_create.2, mknod.2, mlock.2, modify_ldt.2, msgctl.2, msgget.2, msgop.2, readlink.2, readv.2, reboot.2, recvmmsg.2, rename.2, request_key.2, restart_syscall.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, seccomp.2, select_tut.2, semctl.2, semget.2, semop.2, set_thread_area.2, seteuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigprocmask.2, stat.2, symlink.2, syscall.2, sysctl.2, unlink.2, bindresvport.3, byteorder.3, dlopen.3, endian.3, error.3, ffs.3, fmemopen.3, getcwd.3, getlogin.3, getnetent.3, getprotoent.3, getservent.3, getumask.3, getutent.3, glob.3, isalpha.3, lio_listio.3, login.3, mbsinit.3, mbstowcs.3, mbtowc.3, mkstemp.3, nextup.3, ntp_gettime.3, posix_fallocate.3, posix_spawn.3, pthread_join.3, pthread_rwlockattr_setkind_np.3, random.3, rcmd.3, realpath.3, resolver.3, setjmp.3, setnetgrent.3, sigvec.3, strerror.3, strverscmp.3, system.3, toupper.3, towlower.3, towupper.3, wcstombs.3, wordexp.3, cciss.4, loop.4, mouse.4, random.4, core.5, group.5, hosts.5, resolv.conf.5, ascii.7, environ.7, epoll.7, glob.7, ip.7, mq_overview.7, packet.7, pipe.7, raw.7, sched.7, signal.7, socket.7, symlink.7, ld.so.8, sln.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-08 10:53:47 +00:00
|
|
|
.TH MEMUSAGESTAT 1 2016-10-08 "GNU" "Linux programmer's manual"
|
2014-09-01 08:53:25 +00:00
|
|
|
.SH NAME
|
|
|
|
memusagestat \- generate graphic from memory profiling data
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.BR memusagestat " [\fIoption\fR]... \fIdatafile\fR [\fIoutfile\fR]"
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B memusagestat
|
2014-09-01 12:30:34 +00:00
|
|
|
creates a PNG file containing a graphical representation of the
|
|
|
|
memory profiling data in the file
|
|
|
|
.IR datafile ;
|
|
|
|
that file is generated via the
|
|
|
|
.I -d
|
|
|
|
(or
|
|
|
|
.IR --data )
|
|
|
|
option of
|
|
|
|
.BR memusage (1).
|
|
|
|
|
|
|
|
The red line in the graph shows the heap usage (allocated memory)
|
|
|
|
and the green line shows the stack usage.
|
|
|
|
The x-scale is either the number of memory-handling function calls or
|
|
|
|
(if the
|
|
|
|
.I -t
|
|
|
|
option is specified)
|
|
|
|
time.
|
2014-09-01 08:53:25 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
|
|
.BI \-o\ file \fR,\ \fB\-\-output= file
|
|
|
|
Name of the output file.
|
|
|
|
.TP
|
|
|
|
.BI \-s\ string \fR,\ \fB\-\-string= string
|
2014-09-01 12:30:34 +00:00
|
|
|
Use
|
|
|
|
.I string
|
|
|
|
as the title inside the output graph.
|
2014-09-01 08:53:25 +00:00
|
|
|
.TP
|
|
|
|
.BI \-t\fR,\ \fB\-\-time
|
2014-09-01 12:30:34 +00:00
|
|
|
Use time (rather than number of function calls) as the scale for the X axis.
|
2014-09-01 08:53:25 +00:00
|
|
|
.TP
|
|
|
|
.BI \-T\fR,\ \fB\-\-total
|
2014-09-01 12:30:34 +00:00
|
|
|
Also draw a graph of total memory consumption.
|
2014-09-01 08:53:25 +00:00
|
|
|
.TP
|
|
|
|
.BI \-x\ size \fR,\ \fB\-\-x-size= size
|
2014-09-01 12:30:34 +00:00
|
|
|
Make the output graph
|
|
|
|
.I size
|
|
|
|
pixels wide.
|
2014-09-01 08:53:25 +00:00
|
|
|
.TP
|
|
|
|
.BI \-y\ size \fR,\ \fB\-\-y\-size= size
|
2014-09-01 12:30:34 +00:00
|
|
|
Make the output graph
|
|
|
|
.I size
|
|
|
|
pixels high.
|
2014-09-01 08:53:25 +00:00
|
|
|
.TP
|
|
|
|
.BI \-?\fR,\ \fB\-\-help
|
2014-09-01 12:30:34 +00:00
|
|
|
Print a help message and exit.
|
2014-09-01 08:53:25 +00:00
|
|
|
.TP
|
|
|
|
.BI \fB\-\-usage
|
|
|
|
Print a short usage message and exit.
|
|
|
|
.TP
|
|
|
|
.BI \-V\fR,\ \fB\-\-version
|
|
|
|
Print version information and exit.
|
|
|
|
.SH BUGS
|
2014-09-01 12:30:34 +00:00
|
|
|
To report bugs, see
|
|
|
|
.UR http://www.gnu.org/software/libc/bugs.html
|
|
|
|
.UE
|
2016-08-07 19:08:19 +00:00
|
|
|
.SH EXAMPLE
|
|
|
|
See
|
|
|
|
.BR memusage (1).
|
2014-09-01 08:53:25 +00:00
|
|
|
.SH SEE ALSO
|
2014-09-01 12:30:34 +00:00
|
|
|
.BR memusage (1),
|
|
|
|
.BR mtrace (1)
|