projects / linux-2.6-block.git / blame
| 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] |