Massif: a heap profiler
--massif-out-file=<file> [default:
massif.out.%p]
Write the profile data to
file
rather than to the default output file,
massif.out.<pid>
. The
%p
and
%q
format
specifiers can be used to embed the process ID and/or the contents of an environment variable in the name, as is the
case for the core option
--log-file
.
9.4. Massif Monitor Commands
The Massif tool provides monitor commands handled by the Valgrind gdbserver (see
Monitor command handling by
the Valgrind gdbserver
).
•
snapshot [<filename>]
requests to take a snapshot and save it in the given <filename> (default mas-
sif.vgdb.out).
•
detailed_snapshot [<filename>]
requests to take a detailed snapshot and save it in the given <filename>
(default massif.vgdb.out).
9.5. Massif Client Requests
Massif does not have a
massif.h
file,
but it does implement two of the core client requests:
VALGRIND_MALLOCLIKE_BLOCK
and
VALGRIND_FREELIKE_BLOCK
;
they are described in
The Client
Request mechanism
.
9.6. ms_print Command-line Options
ms_print’s options are:
-h --help
Show the help message.
--version
Show the version number.
--threshold=<m.n> [default:
1.0]
Same as Massif’s
--threshold
option, but applied after profiling rather than during.
--x=<4..1000> [default:
72]
Width of the graph, in columns.
--y=<4..1000> [default:
20]
Height of the graph, in rows.
9.7. Massif’s Output File Format
Massif’s file format is plain text (i.e. not binary) and deliberately easy to read for both humans and machines.
Nonetheless, the exact format is not described here.
This is because the format is currently very Massif-specific.
In the future we hope to make the format more general, and thus suitable for possible use with other tools. Once this
has been done, the format will be documented here.
148
