Commit | Line | Data |
---|---|---|
028f12ee SE |
1 | perf-mem(1) |
2 | =========== | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | perf-mem - Profile memory accesses | |
7 | ||
8 | SYNOPSIS | |
9 | -------- | |
10 | [verse] | |
11 | 'perf mem' [<options>] (record [<command>] | report) | |
12 | ||
13 | DESCRIPTION | |
14 | ----------- | |
67121f85 | 15 | "perf mem record" runs a command and gathers memory operation data |
028f12ee SE |
16 | from it, into perf.data. Perf record options are accepted and are passed through. |
17 | ||
67121f85 SE |
18 | "perf mem report" displays the result. It invokes perf report with the |
19 | right set of options to display a memory access profile. By default, loads | |
20 | and stores are sampled. Use the -t option to limit to loads or stores. | |
028f12ee | 21 | |
b6394097 AK |
22 | Note that on Intel systems the memory latency reported is the use-latency, |
23 | not the pure load (or store latency). Use latency includes any pipeline | |
24 | queueing delays in addition to the memory subsystem latency. | |
25 | ||
028f12ee SE |
26 | OPTIONS |
27 | ------- | |
28 | <command>...:: | |
29 | Any command you can specify in a shell. | |
30 | ||
31 | -t:: | |
32 | --type=:: | |
67121f85 | 33 | Select the memory operation type: load or store (default: load,store) |
028f12ee SE |
34 | |
35 | -D:: | |
36 | --dump-raw-samples=:: | |
37 | Dump the raw decoded samples on the screen in a format that is easy to parse with | |
38 | one sample per line. | |
39 | ||
40 | -x:: | |
41 | --field-separator:: | |
42 | Specify the field separator used when dump raw samples (-D option). By default, | |
43 | The separator is the space character. | |
44 | ||
45 | -C:: | |
46 | --cpu-list:: | |
47 | Restrict dump of raw samples to those provided via this option. Note that the same | |
48 | option can be passed in record mode. It will be interpreted the same way as perf | |
49 | record. | |
50 | ||
ad16511b JO |
51 | -K:: |
52 | --all-kernel:: | |
53 | Configure all used events to run in kernel space. | |
54 | ||
55 | -U:: | |
56 | --all-user:: | |
57 | Configure all used events to run in user space. | |
58 | ||
b0d745b3 JO |
59 | --ldload:: |
60 | Specify desired latency for loads event. | |
61 | ||
028f12ee SE |
62 | SEE ALSO |
63 | -------- | |
64 | linkperf:perf-record[1], linkperf:perf-report[1] |