Blame view

tools/perf/Documentation/perf-lock.txt 1.17 KB
84c6f88fc   Hitoshi Mitake   perf lock: Fix an...
1
2
3
4
5
6
7
8
9
10
  perf-lock(1)
  ============
  
  NAME
  ----
  perf-lock - Analyze lock events
  
  SYNOPSIS
  --------
  [verse]
d1eec3eca   Namhyung Kim   perf lock: Docume...
11
  'perf lock' {record|report|script|info}
84c6f88fc   Hitoshi Mitake   perf lock: Fix an...
12
13
14
15
16
17
18
19
20
21
  
  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.
84c6f88fc   Hitoshi Mitake   perf lock: Fix an...
22
    'perf lock report' reports statistical data.
d1eec3eca   Namhyung Kim   perf lock: Docume...
23
24
25
26
    'perf lock script' shows raw lock events.
  
    'perf lock info' shows metadata like threads or addresses
    of lock instances.
9826e8329   Marcin Slusarz   perf lock: Docume...
27
28
  COMMON OPTIONS
  --------------
4aace2515   Shawn Bohrer   perf lock: Docume...
29
30
31
  
  -i::
  --input=<file>::
efad14150   Robert Richter   perf report: Acce...
32
          Input file name. (default: perf.data unless stdin is a fifo)
4aace2515   Shawn Bohrer   perf lock: Docume...
33
34
35
36
37
38
39
40
  
  -v::
  --verbose::
          Be more verbose (show symbol address, etc).
  
  -D::
  --dump-raw-trace::
          Dump raw trace in ASCII.
9826e8329   Marcin Slusarz   perf lock: Docume...
41
42
43
44
45
46
  REPORT OPTIONS
  --------------
  
  -k::
  --key=<value>::
          Sorting key. Possible values: acquired (default), contended,
f37376cd7   Davidlohr Bueso   perf lock: Accoun...
47
  	avg_wait, wait_total, wait_max, wait_min.
9826e8329   Marcin Slusarz   perf lock: Docume...
48

d1eec3eca   Namhyung Kim   perf lock: Docume...
49
50
51
52
53
54
55
56
57
58
  INFO OPTIONS
  ------------
  
  -t::
  --threads::
  	dump thread list in perf.data
  
  -m::
  --map::
  	dump map of lock instances (address:name table)
84c6f88fc   Hitoshi Mitake   perf lock: Fix an...
59
60
61
  SEE ALSO
  --------
  linkperf:perf[1]