^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) perf-mem(1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) ===========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) NAME
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) ----
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) perf-mem - Profile memory accesses
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) SYNOPSIS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) --------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) [verse]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 'perf mem' [<options>] (record [<command>] | report)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) DESCRIPTION
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) "perf mem record" runs a command and gathers memory operation data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) from it, into perf.data. Perf record options are accepted and are passed through.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) "perf mem report" displays the result. It invokes perf report with the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) right set of options to display a memory access profile. By default, loads
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) and stores are sampled. Use the -t option to limit to loads or stores.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Note that on Intel systems the memory latency reported is the use-latency,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) not the pure load (or store latency). Use latency includes any pipeline
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) queueing delays in addition to the memory subsystem latency.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) OPTIONS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) -------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) <command>...::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Any command you can specify in a shell.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) -i::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) --input=<file>::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Input file name.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) -f::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) --force::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) Don't do ownership validation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) -t::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) --type=<type>::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Select the memory operation type: load or store (default: load,store)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) -D::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) --dump-raw-samples::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) Dump the raw decoded samples on the screen in a format that is easy to parse with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) one sample per line.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) -x::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) --field-separator=<separator>::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Specify the field separator used when dump raw samples (-D option). By default,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) The separator is the space character.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) -C::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) --cpu=<cpu>::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) Monitor only on the list of CPUs provided. Multiple CPUs can be provided as a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. Default
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) is to monitor all CPUS.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) -U::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) --hide-unresolved::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) Only display entries resolved to a symbol.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) -p::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) --phys-data::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) Record/Report sample physical addresses
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) RECORD OPTIONS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) --------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) -e::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) --event <event>::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) Event selector. Use 'perf mem record -e list' to list available events.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) -K::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) --all-kernel::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) Configure all used events to run in kernel space.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) -U::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) --all-user::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) Configure all used events to run in user space.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) -v::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) --verbose::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) Be more verbose (show counter open errors, etc)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) --ldlat <n>::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) Specify desired latency for loads event. (x86 only)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) In addition, for report all perf report options are valid, and for record
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) all perf record options.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) SEE ALSO
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) --------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) linkperf:perf-record[1], linkperf:perf-report[1]