perf-lock.txt (2486B)
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]