Commit | Line | Data |
---|---|---|
84c6f88f HM |
1 | perf-lock(1) |
2 | ============ | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | perf-lock - Analyze lock events | |
7 | ||
8 | SYNOPSIS | |
9 | -------- | |
10 | [verse] | |
d1eec3ec | 11 | 'perf lock' {record|report|script|info} |
84c6f88f HM |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
15 | You can analyze various lock behaviours | |
16 | and 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 | ||
84c6f88f HM |
23 | 'perf lock report' reports statistical data. |
24 | ||
d1eec3ec NK |
25 | 'perf lock script' shows raw lock events. |
26 | ||
27 | 'perf lock info' shows metadata like threads or addresses | |
28 | of lock instances. | |
29 | ||
9826e832 MS |
30 | COMMON OPTIONS |
31 | -------------- | |
4aace251 SB |
32 | |
33 | -i:: | |
34 | --input=<file>:: | |
efad1415 | 35 | Input file name. (default: perf.data unless stdin is a fifo) |
4aace251 SB |
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 | ||
9826e832 MS |
45 | REPORT OPTIONS |
46 | -------------- | |
47 | ||
48 | -k:: | |
49 | --key=<value>:: | |
50 | Sorting key. Possible values: acquired (default), contended, | |
f37376cd | 51 | avg_wait, wait_total, wait_max, wait_min. |
9826e832 | 52 | |
d1eec3ec NK |
53 | INFO 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 | ||
84c6f88f HM |
64 | SEE ALSO |
65 | -------- | |
66 | linkperf:perf[1] |