Home | History | Annotate | Download | only in Documentation
      1 perf-lock(1)
      2 ============
      3 
      4 NAME
      5 ----
      6 perf-lock - Analyze lock events
      7 
      8 SYNOPSIS
      9 --------
     10 [verse]
     11 'perf lock' {record|report|script|info}
     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 
     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 
     30 COMMON 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 REPORT OPTIONS
     46 --------------
     47 
     48 -k::
     49 --key=<value>::
     50         Sorting key. Possible values: acquired (default), contended,
     51         wait_total, wait_max, wait_min.
     52 
     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 
     64 SEE ALSO
     65 --------
     66 linkperf:perf[1]
     67