| perf-lock(1) |
| ============ |
| |
| NAME |
| ---- |
| perf-lock - Analyze lock events |
| |
| SYNOPSIS |
| -------- |
| [verse] |
| 'perf lock' {record|report|script|info} |
| |
| DESCRIPTION |
| ----------- |
| You can analyze various lock behaviours |
| and statistics with this 'perf lock' command. |
| |
| 'perf lock record <command>' records lock events |
| between start and end <command>. And this command |
| produces the file "perf.data" which contains tracing |
| results of lock events. |
| |
| 'perf lock report' reports statistical data. |
| |
| 'perf lock script' shows raw lock events. |
| |
| 'perf lock info' shows metadata like threads or addresses |
| of lock instances. |
| |
| COMMON OPTIONS |
| -------------- |
| |
| -i:: |
| --input=<file>:: |
| Input file name. (default: perf.data unless stdin is a fifo) |
| |
| -v:: |
| --verbose:: |
| Be more verbose (show symbol address, etc). |
| |
| -D:: |
| --dump-raw-trace:: |
| Dump raw trace in ASCII. |
| |
| -f:: |
| --force:: |
| Don't complain, do it. |
| |
| REPORT OPTIONS |
| -------------- |
| |
| -k:: |
| --key=<value>:: |
| Sorting key. Possible values: acquired (default), contended, |
| avg_wait, wait_total, wait_max, wait_min. |
| |
| -F:: |
| --field=<value>:: |
| Output fields. By default it shows all the fields but users can |
| customize that using this. Possible values: acquired, contended, |
| avg_wait, wait_total, wait_max, wait_min. |
| |
| -c:: |
| --combine-locks:: |
| Merge lock instances in the same class (based on name). |
| |
| -t:: |
| --threads:: |
| The -t option is to show per-thread lock stat like below: |
| |
| $ perf lock report -t -F acquired,contended,avg_wait |
| |
| Name acquired contended avg wait (ns) |
| |
| perf 240569 9 5784 |
| swapper 106610 19 543 |
| :15789 17370 2 14538 |
| ContainerMgr 8981 6 874 |
| sleep 5275 1 11281 |
| ContainerThread 4416 4 944 |
| RootPressureThr 3215 5 1215 |
| rcu_preempt 2954 0 0 |
| ContainerMgr 2560 0 0 |
| unnamed 1873 0 0 |
| EventManager_De 1845 1 636 |
| futex-default-S 1609 0 0 |
| |
| INFO OPTIONS |
| ------------ |
| |
| -t:: |
| --threads:: |
| dump thread list in perf.data |
| |
| -m:: |
| --map:: |
| dump map of lock instances (address:name table) |
| |
| SEE ALSO |
| -------- |
| linkperf:perf[1] |