0001 perf(1)
0002 =======
0003
0004 NAME
0005 ----
0006 perf - Performance analysis tools for Linux
0007
0008 SYNOPSIS
0009 --------
0010 [verse]
0011 'perf' [--version] [--help] [OPTIONS] COMMAND [ARGS]
0012
0013 OPTIONS
0014 -------
0015 -h::
0016 --help::
0017 Run perf help command.
0018
0019 -v::
0020 --version::
0021 Display perf version.
0022
0023 -vv::
0024 Print the compiled-in status of libraries.
0025
0026 --exec-path::
0027 Display or set exec path.
0028
0029 --html-path::
0030 Display html documentation path.
0031
0032 -p::
0033 --paginate::
0034 Set up pager.
0035
0036 --no-pager::
0037 Do not set pager.
0038
0039 --buildid-dir::
0040 Setup buildid cache directory. It has higher priority
0041 than buildid.dir config file option.
0042
0043 --list-cmds::
0044 List the most commonly used perf commands.
0045
0046 --list-opts::
0047 List available perf options.
0048
0049 --debugfs-dir::
0050 Set debugfs directory or set environment variable PERF_DEBUGFS_DIR.
0051
0052 --debug::
0053 Setup debug variable (see list below) in value
0054 range (0, 10). Use like:
0055 --debug verbose # sets verbose = 1
0056 --debug verbose=2 # sets verbose = 2
0057
0058 List of debug variables allowed to set:
0059 verbose - general debug messages
0060 ordered-events - ordered events object debug messages
0061 data-convert - data convert command debug messages
0062 stderr - write debug output (option -v) to stderr
0063 in browser mode
0064 perf-event-open - Print perf_event_open() arguments and
0065 return value
0066
0067 DESCRIPTION
0068 -----------
0069 Performance counters for Linux are a new kernel-based subsystem
0070 that provide a framework for all things performance analysis. It
0071 covers hardware level (CPU/PMU, Performance Monitoring Unit) features
0072 and software features (software counters, tracepoints) as well.
0073
0074 SEE ALSO
0075 --------
0076 linkperf:perf-stat[1], linkperf:perf-top[1],
0077 linkperf:perf-record[1], linkperf:perf-report[1],
0078 linkperf:perf-list[1]
0079
0080 linkperf:perf-annotate[1],linkperf:perf-archive[1],linkperf:perf-arm-spe[1],
0081 linkperf:perf-bench[1], linkperf:perf-buildid-cache[1],
0082 linkperf:perf-buildid-list[1], linkperf:perf-c2c[1],
0083 linkperf:perf-config[1], linkperf:perf-data[1], linkperf:perf-diff[1],
0084 linkperf:perf-evlist[1], linkperf:perf-ftrace[1],
0085 linkperf:perf-help[1], linkperf:perf-inject[1],
0086 linkperf:perf-intel-pt[1], linkperf:perf-iostat[1], linkperf:perf-kallsyms[1],
0087 linkperf:perf-kmem[1], linkperf:perf-kvm[1], linkperf:perf-lock[1],
0088 linkperf:perf-mem[1], linkperf:perf-probe[1], linkperf:perf-sched[1],
0089 linkperf:perf-script[1], linkperf:perf-test[1],
0090 linkperf:perf-trace[1], linkperf:perf-version[1]