'\" t
.\"     Title: perf
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 1.5.7.1
.\"      Date: 2018-11-27
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF_4.19" "1" "2018-11-27" "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
.nf
\fIperf\fP [\-\-version] [\-\-help] [OPTIONS] COMMAND [ARGS]
.fi
.br
.SH "OPTIONS"
.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
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
.fi
.if n .RE
.RE
.sp
\-\-buildid\-dir
.RS 4
Setup buildid cache directory. It has higher priority than
buildid.dir config file option.
.RE
.sp
\-v, \-\-version
.RS 4
Display perf version.
.RE
.sp
\-h, \-\-help
.RS 4
Run perf help command.
.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)