xref: /linux/tools/perf/Documentation/perf-lock.txt (revision fcc8487d477a3452a1d0ccbdd4c5e0e1e3cb8bed)
1perf-lock(1)
2============
3
4NAME
5----
6perf-lock - Analyze lock events
7
8SYNOPSIS
9--------
10[verse]
11'perf lock' {record|report|script|info}
12
13DESCRIPTION
14-----------
15You can analyze various lock behaviours
16and statistics with this 'perf lock' command.
17
18  'perf lock record <command>' records lock events
19  between start and end <command>. And this command
20  produces the file "perf.data" which contains tracing
21  results of lock events.
22
23  'perf lock report' reports statistical data.
24
25  'perf lock script' shows raw lock events.
26
27  'perf lock info' shows metadata like threads or addresses
28  of lock instances.
29
30COMMON OPTIONS
31--------------
32
33-i::
34--input=<file>::
35        Input file name. (default: perf.data unless stdin is a fifo)
36
37-v::
38--verbose::
39        Be more verbose (show symbol address, etc).
40
41-D::
42--dump-raw-trace::
43        Dump raw trace in ASCII.
44
45REPORT OPTIONS
46--------------
47
48-k::
49--key=<value>::
50        Sorting key. Possible values: acquired (default), contended,
51	avg_wait, wait_total, wait_max, wait_min.
52
53INFO OPTIONS
54------------
55
56-t::
57--threads::
58	dump thread list in perf.data
59
60-m::
61--map::
62	dump map of lock instances (address:name table)
63
64SEE ALSO
65--------
66linkperf:perf[1]
67