mirror of
https://github.com/torvalds/linux.git
synced 2024-12-03 17:41:22 +00:00
b739759c4e
Add a perf man page document that describes how to exploit AMD IBS with Linux perf. Brief intro about IBS and simple one-liner examples will help naive users to get started. This is not meant to be an exhaustive IBS guide. User should refer latest AMD64 Architecture Programmer's Manual for detailed description of IBS. Usage: $ man perf-amd-ibs Signed-off-by: Ravi Bangoria <ravi.bangoria@amd.com> Reviewed-by: Arnaldo Carvalho de Melo <acme@redhat.com> Cc: ananth.narayan@amd.com Cc: sandipan.das@amd.com Cc: santosh.shukla@amd.com Signed-off-by: Namhyung Kim <namhyung@kernel.org> Link: https://lore.kernel.org/r/20240620054104.815-1-ravi.bangoria@amd.com
97 lines
2.7 KiB
Plaintext
97 lines
2.7 KiB
Plaintext
perf(1)
|
|
=======
|
|
|
|
NAME
|
|
----
|
|
perf - Performance analysis tools for Linux
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf' [--version] [--help] [OPTIONS] COMMAND [ARGS]
|
|
|
|
OPTIONS
|
|
-------
|
|
-h::
|
|
--help::
|
|
Run perf help command.
|
|
|
|
-v::
|
|
--version::
|
|
Display perf version.
|
|
|
|
-vv::
|
|
Print the compiled-in status of libraries.
|
|
|
|
--exec-path::
|
|
Display or set exec path.
|
|
|
|
--html-path::
|
|
Display html documentation path.
|
|
|
|
-p::
|
|
--paginate::
|
|
Set up pager.
|
|
|
|
--no-pager::
|
|
Do not set pager.
|
|
|
|
--buildid-dir::
|
|
Setup buildid cache directory. It has higher priority
|
|
than buildid.dir config file option.
|
|
|
|
--list-cmds::
|
|
List the most commonly used perf commands.
|
|
|
|
--list-opts::
|
|
List available perf options.
|
|
|
|
--debugfs-dir::
|
|
Set debugfs directory or set environment variable PERF_DEBUGFS_DIR.
|
|
|
|
--debug::
|
|
Setup debug variable (see list below) in value
|
|
range (0, 10). Use like:
|
|
--debug verbose # sets verbose = 1
|
|
--debug verbose=2 # sets verbose = 2
|
|
|
|
List of debug variables allowed to set:
|
|
verbose - general debug messages
|
|
ordered-events - ordered events object debug messages
|
|
data-convert - data convert command debug messages
|
|
stderr - write debug output (option -v) to stderr
|
|
in browser mode
|
|
perf-event-open - Print perf_event_open() arguments and
|
|
return value
|
|
kmaps - Print kernel and module maps (perf script
|
|
and perf report without browser)
|
|
|
|
--debug-file::
|
|
Write debug output to a specified file.
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Performance counters for Linux are a new kernel-based subsystem
|
|
that provide a framework for all things performance analysis. It
|
|
covers hardware level (CPU/PMU, Performance Monitoring Unit) features
|
|
and software features (software counters, tracepoints) as well.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkperf:perf-stat[1], linkperf:perf-top[1],
|
|
linkperf:perf-record[1], linkperf:perf-report[1],
|
|
linkperf:perf-list[1]
|
|
|
|
linkperf:perf-amd-ibs[1], linkperf:perf-annotate[1],
|
|
linkperf:perf-archive[1], linkperf:perf-arm-spe[1],
|
|
linkperf:perf-bench[1], linkperf:perf-buildid-cache[1],
|
|
linkperf:perf-buildid-list[1], linkperf:perf-c2c[1],
|
|
linkperf:perf-config[1], linkperf:perf-data[1], linkperf:perf-diff[1],
|
|
linkperf:perf-evlist[1], linkperf:perf-ftrace[1],
|
|
linkperf:perf-help[1], linkperf:perf-inject[1],
|
|
linkperf:perf-intel-pt[1], linkperf:perf-iostat[1], linkperf:perf-kallsyms[1],
|
|
linkperf:perf-kmem[1], linkperf:perf-kvm[1], linkperf:perf-lock[1],
|
|
linkperf:perf-mem[1], linkperf:perf-probe[1], linkperf:perf-sched[1],
|
|
linkperf:perf-script[1], linkperf:perf-test[1],
|
|
linkperf:perf-trace[1], linkperf:perf-version[1]
|