Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit d19d4ab

Browse files
author
njn
committedAug 4, 2009
A couple of minor Massif manual improvements.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@10707 a5019735-40e9-0310-863c-91ae7b9d1cf9
1 parent a15b666 commit d19d4ab

File tree

1 file changed

+16
-10
lines changed

1 file changed

+16
-10
lines changed
 

‎massif/docs/ms-manual.xml

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,8 @@ valgrind --tool=massif prog
6868
statistics are printed to Valgrind's commentary; all of Massif's profiling
6969
data is written to a file. By default, this file is called
7070
<filename>massif.out.&lt;pid&gt;</filename>, where
71-
<filename>&lt;pid&gt;</filename> is the process ID.</para>
71+
<filename>&lt;pid&gt;</filename> is the process ID, although this filename
72+
can be changed with the <option>--massif-out-file</option> option.</para>
7273

7374
<para>To see the information gathered by Massif in an easy-to-read form, use
7475
the ms_print script. If the output file's name is
@@ -222,14 +223,16 @@ Number of snapshots: 25
222223
Detailed snapshots: [9, 14 (peak), 24]
223224
]]></screen>
224225

225-
<para>Each vertical bar represents a snapshot, i.e. a measurement of the
226-
memory usage at a certain point in time. If the next snapshot is more than
227-
one column away, a horizontal line of characters is drawn from the top of
228-
the snapshot to just before the next snapshot column. The text at the
229-
bottom show that 25 snapshots were taken for this program, which is one per
230-
heap allocation/deallocation, plus a couple of extras. Massif starts by
231-
taking snapshots for every heap allocation/deallocation, but as a program
232-
runs for longer, it takes snapshots less frequently. It also discards older
226+
<para>The size of the graph can be changed with ms_print's
227+
<option>--x</option> and <option>--y</option> options. Each vertical bar
228+
represents a snapshot, i.e. a measurement of the memory usage at a certain
229+
point in time. If the next snapshot is more than one column away, a
230+
horizontal line of characters is drawn from the top of the snapshot to just
231+
before the next snapshot column. The text at the bottom show that 25
232+
snapshots were taken for this program, which is one per heap
233+
allocation/deallocation, plus a couple of extras. Massif starts by taking
234+
snapshots for every heap allocation/deallocation, but as a program runs for
235+
longer, it takes snapshots less frequently. It also discards older
233236
snapshots as the program goes on; when it reaches the maximum number of
234237
snapshots (100 by default, although changeable with the
235238
<option>--max-snapshots</option> option) half of them are
@@ -358,7 +361,10 @@ a small amount of information is recorded for each one:</para>
358361

359362
<listitem><para>The size of the stack(s). By default, stack profiling is
360363
off as it slows Massif down greatly. Therefore, the stack column is zero
361-
in the example.</para></listitem>
364+
in the example. Stack profiling can be turned on with the
365+
<option>--stacks=yes</option> option.
366+
367+
</para></listitem>
362368
</itemizedlist>
363369

364370
<para>The next snapshot is detailed. As well as the basic counts, it gives

0 commit comments

Comments
 (0)
Please sign in to comment.