@@ -68,7 +68,8 @@ valgrind --tool=massif prog
68
68
statistics are printed to Valgrind's commentary; all of Massif's profiling
69
69
data is written to a file. By default, this file is called
70
70
<filename >massif.out.< pid> </filename >, where
71
- <filename >< pid> </filename > is the process ID.</para >
71
+ <filename >< pid> </filename > is the process ID, although this filename
72
+ can be changed with the <option >--massif-out-file</option > option.</para >
72
73
73
74
<para >To see the information gathered by Massif in an easy-to-read form, use
74
75
the ms_print script. If the output file's name is
@@ -222,14 +223,16 @@ Number of snapshots: 25
222
223
Detailed snapshots: [9, 14 (peak), 24]
223
224
]]> </screen >
224
225
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
233
236
snapshots as the program goes on; when it reaches the maximum number of
234
237
snapshots (100 by default, although changeable with the
235
238
<option >--max-snapshots</option > option) half of them are
@@ -358,7 +361,10 @@ a small amount of information is recorded for each one:</para>
358
361
359
362
<listitem ><para >The size of the stack(s). By default, stack profiling is
360
363
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 >
362
368
</itemizedlist >
363
369
364
370
<para >The next snapshot is detailed. As well as the basic counts, it gives
0 commit comments