'\" t
.\"     Title: perf
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2018-01-14
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF_4.14" "1" "2018\-01\-14" "perf" "perf Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
perf \- Performance analysis tools for Linux
.SH "SYNOPSIS"
.sp
.nf
\fIperf\fR [\-\-version] [\-\-help] [OPTIONS] COMMAND [ARGS]
.fi
.SH "OPTIONS"
.PP
\-\-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
.PP
\-\-buildid\-dir
.RS 4
Setup buildid cache directory\&. It has higher priority than buildid\&.dir config file option\&.
.RE
.PP
\-v, \-\-version
.RS 4
Display perf version\&.
.RE
.PP
\-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
\fBperf_4.14-stat\fR(1), \fBperf_4.14-top\fR(1), \fBperf_4.14-record\fR(1), \fBperf_4.14-report\fR(1), \fBperf_4.14-list\fR(1)