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
59Record system-wide timechart:
60
61  $ perf timechart record
62
63  then generate timechart and highlight 'gcc' tasks:
64
65  $ perf timechart --highlight gcc
66
67-n::
68--proc-num::
69        Print task info for at least given number of tasks.
70-t::
71--topology::
72        Sort CPUs according to topology.
73--highlight=<duration_nsecs|task_name>::
74	Highlight tasks (using different color) that run more than given
75	duration or tasks with given name. If number is given it's interpreted
76	as number of nanoseconds. If non-numeric string is given it's
77	interpreted as task name.
78
79RECORD OPTIONS
80--------------
81-P::
82--power-only::
83        Record only power-related events
84-T::
85--tasks-only::
86        Record only tasks-related events
87-g::
88--callchain::
89        Do call-graph (stack chain/backtrace) recording
90
91SEE ALSO
92--------
93linkperf:perf-record[1]
94