^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) perf(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 - Performance analysis tools for Linux
^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' [--version] [--help] [OPTIONS] COMMAND [ARGS]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) OPTIONS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) -------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) -h::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) --help::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Run perf help command.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) -v::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) --version::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) Display perf version.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) -vv::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Print the compiled-in status of libraries.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) --exec-path::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Display or set exec path.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) --html-path::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) Display html documentation path.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) -p::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) --paginate::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Set up pager.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) --no-pager::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) Do not set pager.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) --buildid-dir::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Setup buildid cache directory. It has higher priority
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) than buildid.dir config file option.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) --list-cmds::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) List the most commonly used perf commands.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) --list-opts::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) List available perf options.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) --debugfs-dir::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Set debugfs directory or set environment variable PERF_DEBUGFS_DIR.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) --debug::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) Setup debug variable (see list below) in value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) range (0, 10). Use like:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) --debug verbose # sets verbose = 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) --debug verbose=2 # sets verbose = 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) List of debug variables allowed to set:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) verbose - general debug messages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) ordered-events - ordered events object debug messages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) data-convert - data convert command debug messages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) stderr - write debug output (option -v) to stderr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) in browser mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) perf-event-open - Print perf_event_open() arguments and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) return value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) DESCRIPTION
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) Performance counters for Linux are a new kernel-based subsystem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) that provide a framework for all things performance analysis. It
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) covers hardware level (CPU/PMU, Performance Monitoring Unit) features
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) and software features (software counters, tracepoints) as well.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) SEE ALSO
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) --------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) linkperf:perf-stat[1], linkperf:perf-top[1],
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) linkperf:perf-record[1], linkperf:perf-report[1],
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) linkperf:perf-list[1]