'\" t
.\"     Title: perf
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.12
.\"      Date: 2021-10-10
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF_5.14" "1" "2021-10-10" "perf" "perf Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
perf \- Performance analysis tools for Linux
.SH "SYNOPSIS"
.sp
.sp
.nf
\fIperf\fP [\-\-version] [\-\-help] [OPTIONS] COMMAND [ARGS]
.fi
.br
.SH "OPTIONS"
.sp
\-h, \-\-help
.RS 4
Run perf help command.
.RE
.sp
\-v, \-\-version
.RS 4
Display perf version.
.RE
.sp
\-vv
.RS 4
Print the compiled\-in status of libraries.
.RE
.sp
\-\-exec\-path
.RS 4
Display or set exec path.
.RE
.sp
\-\-html\-path
.RS 4
Display html documentation path.
.RE
.sp
\-p, \-\-paginate
.RS 4
Set up pager.
.RE
.sp
\-\-no\-pager
.RS 4
Do not set pager.
.RE
.sp
\-\-buildid\-dir
.RS 4
Setup buildid cache directory. It has higher priority
than buildid.dir config file option.
.RE
.sp
\-\-list\-cmds
.RS 4
List the most commonly used perf commands.
.RE
.sp
\-\-list\-opts
.RS 4
List available perf options.
.RE
.sp
\-\-debugfs\-dir
.RS 4
Set debugfs directory or set environment variable PERF_DEBUGFS_DIR.
.RE
.sp
\-\-debug
.RS 4
Setup debug variable (see list below) in value
range (0, 10). Use like:
\-\-debug verbose   # sets verbose = 1
\-\-debug verbose=2 # sets verbose = 2
.sp
.if n .RS 4
.nf
.fam C
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
.fam
.fi
.if n .RE
.RE
.SH "DESCRIPTION"
.sp
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.
.SH "SEE ALSO"
.sp
perf\-stat(1), perf\-top(1),
perf\-record(1), perf\-report(1),
perf\-list(1)
.sp
perf\-annotate(1),perf\-archive(1),
perf\-bench(1), perf\-buildid\-cache(1),
perf\-buildid\-list(1), perf\-c2c(1),
perf\-config(1), perf\-data(1), perf\-diff(1),
perf\-evlist(1), perf\-ftrace(1),
perf\-help(1), perf\-inject(1),
perf\-intel\-pt(1), perf\-kallsyms(1),
perf\-kmem(1), perf\-kvm(1), perf\-lock(1),
perf\-mem(1), perf\-probe(1), perf\-sched(1),
perf\-script(1), perf\-test(1),
perf\-trace(1), perf\-version(1)