1151750ceSArjan van de Venperf-timechart(1)
2151750ceSArjan van de Ven=================
3151750ceSArjan van de Ven
4151750ceSArjan van de VenNAME
5151750ceSArjan van de Ven----
6151750ceSArjan van de Venperf-timechart - Tool to visualize total system behavior during a workload
7151750ceSArjan van de Ven
8151750ceSArjan van de VenSYNOPSIS
9151750ceSArjan van de Ven--------
10151750ceSArjan van de Ven[verse]
11d366c53eSRamkumar Ramachandra'perf timechart' record <command>
12d366c53eSRamkumar Ramachandra'perf timechart' [<options>]
13151750ceSArjan van de Ven
14151750ceSArjan van de VenDESCRIPTION
15151750ceSArjan van de Ven-----------
16151750ceSArjan van de VenThere are two variants of perf timechart:
17151750ceSArjan van de Ven
18151750ceSArjan van de Ven  'perf timechart record <command>' to record the system level events
19151750ceSArjan van de Ven  of an arbitrary workload.
20151750ceSArjan van de Ven
21151750ceSArjan van de Ven  'perf timechart' to turn a trace into a Scalable Vector Graphics file,
22151750ceSArjan van de Ven  that can be viewed with popular SVG viewers such as 'Inkscape'.
23151750ceSArjan van de Ven
24151750ceSArjan van de VenOPTIONS
25151750ceSArjan van de Ven-------
26151750ceSArjan van de Ven-o::
27151750ceSArjan van de Ven--output=::
28151750ceSArjan van de Ven        Select the output file (default: output.svg)
29151750ceSArjan van de Ven-i::
30151750ceSArjan van de Ven--input=::
31efad1415SRobert Richter        Select the input file (default: perf.data unless stdin is a fifo)
325094b655SArjan van de Ven-w::
335094b655SArjan van de Ven--width=::
345094b655SArjan van de Ven        Select the width of the SVG file (default: 1000)
35bbe2987bSArjan van de Ven-P::
3639a90a8eSArjan van de Ven--power-only::
3739a90a8eSArjan van de Ven        Only output the CPU power section of the diagram
38c87097d3SStanislav Fomichev-T::
39c87097d3SStanislav Fomichev--tasks-only::
40c87097d3SStanislav Fomichev        Don't output processor state transitions
41bbe2987bSArjan van de Ven-p::
42bbe2987bSArjan van de Ven--process::
43bbe2987bSArjan van de Ven        Select the processes to display, by name or PID
44151750ceSArjan van de Ven
45ec5761eaSDavid Ahern--symfs=<directory>::
46ec5761eaSDavid Ahern        Look for files with symbols relative to this directory.
47151750ceSArjan van de Ven
48d366c53eSRamkumar RamachandraEXAMPLES
49d366c53eSRamkumar Ramachandra--------
50d366c53eSRamkumar Ramachandra
51d366c53eSRamkumar Ramachandra$ perf timechart record git pull
52d366c53eSRamkumar Ramachandra
53d366c53eSRamkumar Ramachandra  [ perf record: Woken up 13 times to write data ]
54d366c53eSRamkumar Ramachandra  [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ]
55d366c53eSRamkumar Ramachandra
56d366c53eSRamkumar Ramachandra$ perf timechart
57d366c53eSRamkumar Ramachandra
58d366c53eSRamkumar Ramachandra  Written 10.2 seconds of trace to output.svg.
59d366c53eSRamkumar Ramachandra
6054874e32SStanislav Fomichev-n::
6154874e32SStanislav Fomichev--proc-num::
6254874e32SStanislav Fomichev        Print task info for at least given number of tasks.
6354874e32SStanislav Fomichev
64151750ceSArjan van de VenSEE ALSO
65151750ceSArjan van de Ven--------
66151750ceSArjan van de Venlinkperf:perf-record[1]
67