'\" t
.\"     Title: perf-lock
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.10
.\"      Date: 2020-01-06
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF_5.5\-LOCK" "1" "2020-01-06" "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\-lock \- Analyze lock events
.SH "SYNOPSIS"
.sp
.sp
.nf
\fIperf lock\fP {record|report|script|info}
.fi
.br
.SH "DESCRIPTION"
.sp
You can analyze various lock behaviours
and statistics with this \fIperf lock\fP command.
.sp
.if n .RS 4
.nf
\(aqperf lock record <command>\(aq records lock events
between start and end <command>. And this command
produces the file "perf.data" which contains tracing
results of lock events.
.fi
.if n .RE
.sp
.if n .RS 4
.nf
\(aqperf lock report\(aq reports statistical data.
.fi
.if n .RE
.sp
.if n .RS 4
.nf
\(aqperf lock script\(aq shows raw lock events.
.fi
.if n .RE
.sp
.if n .RS 4
.nf
\(aqperf lock info\(aq shows metadata like threads or addresses
of lock instances.
.fi
.if n .RE
.SH "COMMON OPTIONS"
.sp
\-i, \-\-input=<file>
.RS 4
Input file name. (default: perf.data unless stdin is a fifo)
.RE
.sp
\-v, \-\-verbose
.RS 4
Be more verbose (show symbol address, etc).
.RE
.sp
\-D, \-\-dump\-raw\-trace
.RS 4
Dump raw trace in ASCII.
.RE
.sp
\-f, \-\-force
.RS 4
Don\(cqt complan, do it.
.RE
.SH "REPORT OPTIONS"
.sp
\-k, \-\-key=<value>
.RS 4
       Sorting key. Possible values: acquired (default), contended,
avg_wait, wait_total, wait_max, wait_min.
.RE
.SH "INFO OPTIONS"
.sp
\-t, \-\-threads
.RS 4
dump thread list in perf.data
.RE
.sp
\-m, \-\-map
.RS 4
dump map of lock instances (address:name table)
.RE
.SH "SEE ALSO"
.sp
perf(1)