1028f12eeSStephane Eranianperf-mem(1) 2028f12eeSStephane Eranian=========== 3028f12eeSStephane Eranian 4028f12eeSStephane EranianNAME 5028f12eeSStephane Eranian---- 6028f12eeSStephane Eranianperf-mem - Profile memory accesses 7028f12eeSStephane Eranian 8028f12eeSStephane EranianSYNOPSIS 9028f12eeSStephane Eranian-------- 10028f12eeSStephane Eranian[verse] 11028f12eeSStephane Eranian'perf mem' [<options>] (record [<command>] | report) 12028f12eeSStephane Eranian 13028f12eeSStephane EranianDESCRIPTION 14028f12eeSStephane Eranian----------- 1567121f85SStephane Eranian"perf mem record" runs a command and gathers memory operation data 16028f12eeSStephane Eranianfrom it, into perf.data. Perf record options are accepted and are passed through. 17028f12eeSStephane Eranian 1867121f85SStephane Eranian"perf mem report" displays the result. It invokes perf report with the 1967121f85SStephane Eranianright set of options to display a memory access profile. By default, loads 2067121f85SStephane Eranianand stores are sampled. Use the -t option to limit to loads or stores. 21028f12eeSStephane Eranian 22b6394097SAndi KleenNote that on Intel systems the memory latency reported is the use-latency, 23b6394097SAndi Kleennot the pure load (or store latency). Use latency includes any pipeline 24b6394097SAndi Kleenqueueing delays in addition to the memory subsystem latency. 25b6394097SAndi Kleen 26028f12eeSStephane EranianOPTIONS 27028f12eeSStephane Eranian------- 28028f12eeSStephane Eranian<command>...:: 29028f12eeSStephane Eranian Any command you can specify in a shell. 30028f12eeSStephane Eranian 317e99b197SSangwon Hong-f:: 327e99b197SSangwon Hong--force:: 337e99b197SSangwon Hong Don't do ownership validation 347e99b197SSangwon Hong 35028f12eeSStephane Eranian-t:: 36028f12eeSStephane Eranian--type=:: 3767121f85SStephane Eranian Select the memory operation type: load or store (default: load,store) 38028f12eeSStephane Eranian 39028f12eeSStephane Eranian-D:: 40028f12eeSStephane Eranian--dump-raw-samples=:: 41028f12eeSStephane Eranian Dump the raw decoded samples on the screen in a format that is easy to parse with 42028f12eeSStephane Eranian one sample per line. 43028f12eeSStephane Eranian 44028f12eeSStephane Eranian-x:: 45028f12eeSStephane Eranian--field-separator:: 46028f12eeSStephane Eranian Specify the field separator used when dump raw samples (-D option). By default, 47028f12eeSStephane Eranian The separator is the space character. 48028f12eeSStephane Eranian 49028f12eeSStephane Eranian-C:: 50028f12eeSStephane Eranian--cpu-list:: 51028f12eeSStephane Eranian Restrict dump of raw samples to those provided via this option. Note that the same 52028f12eeSStephane Eranian option can be passed in record mode. It will be interpreted the same way as perf 53028f12eeSStephane Eranian record. 54028f12eeSStephane Eranian 55ad16511bSJiri Olsa-K:: 56ad16511bSJiri Olsa--all-kernel:: 57ad16511bSJiri Olsa Configure all used events to run in kernel space. 58ad16511bSJiri Olsa 59ad16511bSJiri Olsa-U:: 60ad16511bSJiri Olsa--all-user:: 61ad16511bSJiri Olsa Configure all used events to run in user space. 62ad16511bSJiri Olsa 63b0d745b3SJiri Olsa--ldload:: 64b0d745b3SJiri Olsa Specify desired latency for loads event. 65b0d745b3SJiri Olsa 66c35aeb9dSKan Liang-p:: 67c35aeb9dSKan Liang--phys-data:: 68c35aeb9dSKan Liang Record/Report sample physical addresses 69c35aeb9dSKan Liang 70*a7e9eab3SAndi KleenIn addition, for report all perf report options are valid, and for record 71*a7e9eab3SAndi Kleenall perf record options. 72*a7e9eab3SAndi Kleen 73028f12eeSStephane EranianSEE ALSO 74028f12eeSStephane Eranian-------- 75028f12eeSStephane Eranianlinkperf:perf-record[1], linkperf:perf-report[1] 76