'\" t
.\"     Title: perf-lock
.\"    Author: [see the "AUTHORS" section]
.\" Generator: Asciidoctor 1.5.4
.\"      Date: 2019-06-19
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF_4.19\-LOCK" "1" "2019-06-19" "perf" "perf Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.LINKSTYLE blue R < >
.SH "NAME"
perf\-lock \- Analyze lock events
.SH "SYNOPSIS"
.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)