| Hitoshi Mitake | 84c6f88 | 2010-02-04 16:08:15 +0900 | [diff] [blame] | 1 | perf-lock(1) |
| 2 | ============ |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | perf-lock - Analyze lock events |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| Namhyung Kim | d1eec3e | 2012-01-29 17:55:56 +0900 | [diff] [blame] | 11 | 'perf lock' {record|report|script|info} |
| Hitoshi Mitake | 84c6f88 | 2010-02-04 16:08:15 +0900 | [diff] [blame] | 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 | |
| Hitoshi Mitake | 84c6f88 | 2010-02-04 16:08:15 +0900 | [diff] [blame] | 23 | 'perf lock report' reports statistical data. |
| 24 | |
| Namhyung Kim | d1eec3e | 2012-01-29 17:55:56 +0900 | [diff] [blame] | 25 | 'perf lock script' shows raw lock events. |
| 26 | |
| 27 | 'perf lock info' shows metadata like threads or addresses |
| 28 | of lock instances. |
| 29 | |
| Marcin Slusarz | 9826e83 | 2011-02-22 21:53:12 +0100 | [diff] [blame] | 30 | COMMON OPTIONS |
| 31 | -------------- |
| Shawn Bohrer | 4aace25 | 2010-11-30 19:57:14 -0600 | [diff] [blame] | 32 | |
| 33 | -i:: |
| 34 | --input=<file>:: |
| Robert Richter | efad141 | 2011-12-07 10:02:54 +0100 | [diff] [blame] | 35 | Input file name. (default: perf.data unless stdin is a fifo) |
| Shawn Bohrer | 4aace25 | 2010-11-30 19:57:14 -0600 | [diff] [blame] | 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 | |
| Marcin Slusarz | 9826e83 | 2011-02-22 21:53:12 +0100 | [diff] [blame] | 45 | REPORT OPTIONS |
| 46 | -------------- |
| 47 | |
| 48 | -k:: |
| 49 | --key=<value>:: |
| 50 | Sorting key. Possible values: acquired (default), contended, |
| Davidlohr Bueso | f37376c | 2013-09-08 19:19:19 -0700 | [diff] [blame] | 51 | avg_wait, wait_total, wait_max, wait_min. |
| Marcin Slusarz | 9826e83 | 2011-02-22 21:53:12 +0100 | [diff] [blame] | 52 | |
| Namhyung Kim | d1eec3e | 2012-01-29 17:55:56 +0900 | [diff] [blame] | 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 | |
| Hitoshi Mitake | 84c6f88 | 2010-02-04 16:08:15 +0900 | [diff] [blame] | 64 | SEE ALSO |
| 65 | -------- |
| 66 | linkperf:perf[1] |