1perf-timechart(1)
2=================
3
4NAME
5----
6perf-timechart - Tool to visualize total system behavior during a workload
7
8SYNOPSIS
9--------
10[verse]
11'perf timechart' [<timechart options>] {record} [<record options>]
12
13DESCRIPTION
14-----------
15There are two variants of perf timechart:
16
17  'perf timechart record <command>' to record the system level events
18  of an arbitrary workload.
19
20  'perf timechart' to turn a trace into a Scalable Vector Graphics file,
21  that can be viewed with popular SVG viewers such as 'Inkscape'.
22
23TIMECHART OPTIONS
24-----------------
25-o::
26--output=::
27        Select the output file (default: output.svg)
28-i::
29--input=::
30        Select the input file (default: perf.data unless stdin is a fifo)
31-w::
32--width=::
33        Select the width of the SVG file (default: 1000)
34-P::
35--power-only::
36        Only output the CPU power section of the diagram
37-T::
38--tasks-only::
39        Don't output processor state transitions
40-p::
41--process::
42        Select the processes to display, by name or PID
43
44--symfs=<directory>::
45        Look for files with symbols relative to this directory.
46
47EXAMPLES
48--------
49
50$ perf timechart record git pull
51
52  [ perf record: Woken up 13 times to write data ]
53  [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ]
54
55$ perf timechart
56
57  Written 10.2 seconds of trace to output.svg.
58
59-n::
60--proc-num::
61        Print task info for at least given number of tasks.
62-t::
63--topology::
64        Sort CPUs according to topology.
65
66RECORD OPTIONS
67--------------
68-P::
69--power-only::
70        Record only power-related events
71-T::
72--tasks-only::
73        Record only tasks-related events
74-g::
75--callchain::
76        Do call-graph (stack chain/backtrace) recording
77
78SEE ALSO
79--------
80linkperf:perf-record[1]
81