xref: /linux/tools/perf/Documentation/perf-mem.txt (revision 028f12ee6beff0961781c5ed3f740e5f3b56f781)
1*028f12eeSStephane Eranianperf-mem(1)
2*028f12eeSStephane Eranian===========
3*028f12eeSStephane Eranian
4*028f12eeSStephane EranianNAME
5*028f12eeSStephane Eranian----
6*028f12eeSStephane Eranianperf-mem - Profile memory accesses
7*028f12eeSStephane Eranian
8*028f12eeSStephane EranianSYNOPSIS
9*028f12eeSStephane Eranian--------
10*028f12eeSStephane Eranian[verse]
11*028f12eeSStephane Eranian'perf mem' [<options>] (record [<command>] | report)
12*028f12eeSStephane Eranian
13*028f12eeSStephane EranianDESCRIPTION
14*028f12eeSStephane Eranian-----------
15*028f12eeSStephane Eranian"perf mem -t <TYPE> record" runs a command and gathers memory operation data
16*028f12eeSStephane Eranianfrom it, into perf.data. Perf record options are accepted and are passed through.
17*028f12eeSStephane Eranian
18*028f12eeSStephane Eranian"perf mem -t <TYPE> report" displays the result. It invokes perf report with the
19*028f12eeSStephane Eranianright set of options to display a memory access profile.
20*028f12eeSStephane Eranian
21*028f12eeSStephane EranianOPTIONS
22*028f12eeSStephane Eranian-------
23*028f12eeSStephane Eranian<command>...::
24*028f12eeSStephane Eranian	Any command you can specify in a shell.
25*028f12eeSStephane Eranian
26*028f12eeSStephane Eranian-t::
27*028f12eeSStephane Eranian--type=::
28*028f12eeSStephane Eranian	Select the memory operation type: load or store (default: load)
29*028f12eeSStephane Eranian
30*028f12eeSStephane Eranian-D::
31*028f12eeSStephane Eranian--dump-raw-samples=::
32*028f12eeSStephane Eranian	Dump the raw decoded samples on the screen in a format that is easy to parse with
33*028f12eeSStephane Eranian	one sample per line.
34*028f12eeSStephane Eranian
35*028f12eeSStephane Eranian-x::
36*028f12eeSStephane Eranian--field-separator::
37*028f12eeSStephane Eranian	Specify the field separator used when dump raw samples (-D option). By default,
38*028f12eeSStephane Eranian	The separator is the space character.
39*028f12eeSStephane Eranian
40*028f12eeSStephane Eranian-C::
41*028f12eeSStephane Eranian--cpu-list::
42*028f12eeSStephane Eranian	Restrict dump of raw samples to those provided via this option. Note that the same
43*028f12eeSStephane Eranian	option can be passed in record mode. It will be interpreted the same way as perf
44*028f12eeSStephane Eranian	record.
45*028f12eeSStephane Eranian
46*028f12eeSStephane EranianSEE ALSO
47*028f12eeSStephane Eranian--------
48*028f12eeSStephane Eranianlinkperf:perf-record[1], linkperf:perf-report[1]
49