projects / deliverable / linux.git / blame
| 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 | ||
| 51 | SEE ALSO | |
| 52 | -------- | |
| 53 | linkperf:perf-record[1], linkperf:perf-report[1] |