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
45-f::
46--force::
47	Don't complain, do it.
48
49REPORT OPTIONS
50--------------
51
52-k::
53--key=<value>::
54        Sorting key. Possible values: acquired (default), contended,
55	avg_wait, wait_total, wait_max, wait_min.
56
57-F::
58--field=<value>::
59        Output fields. By default it shows all the fields but users can
60	customize that using this.  Possible values: acquired, contended,
61	avg_wait, wait_total, wait_max, wait_min.
62
63-c::
64--combine-locks::
65	Merge lock instances in the same class (based on name).
66
67-t::
68--threads::
69    The -t option is to show per-thread lock stat like below:
70
71      $ perf lock report -t -F acquired,contended,avg_wait
72
73                    Name   acquired  contended   avg wait (ns)
74
75                    perf     240569          9            5784
76                 swapper     106610         19             543
77                  :15789      17370          2           14538
78            ContainerMgr       8981          6             874
79                   sleep       5275          1           11281
80         ContainerThread       4416          4             944
81         RootPressureThr       3215          5            1215
82             rcu_preempt       2954          0               0
83            ContainerMgr       2560          0               0
84                 unnamed       1873          0               0
85         EventManager_De       1845          1             636
86         futex-default-S       1609          0               0
87
88INFO OPTIONS
89------------
90
91-t::
92--threads::
93	dump thread list in perf.data
94
95-m::
96--map::
97	dump map of lock instances (address:name table)
98
99SEE ALSO
100--------
101linkperf:perf[1]
102