tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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]