tools/perf/Documentation/perf-lock.txt

   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         avg_wait, 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]