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
38bbe2987bSArjan van de Ven-p::
39bbe2987bSArjan van de Ven--process::
40bbe2987bSArjan van de Ven        Select the processes to display, by name or PID
41151750ceSArjan van de Ven
42ec5761eaSDavid Ahern--symfs=<directory>::
43ec5761eaSDavid Ahern        Look for files with symbols relative to this directory.
44151750ceSArjan van de Ven
45d366c53eSRamkumar RamachandraEXAMPLES
46d366c53eSRamkumar Ramachandra--------
47d366c53eSRamkumar Ramachandra
48d366c53eSRamkumar Ramachandra$ perf timechart record git pull
49d366c53eSRamkumar Ramachandra
50d366c53eSRamkumar Ramachandra  [ perf record: Woken up 13 times to write data ]
51d366c53eSRamkumar Ramachandra  [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ]
52d366c53eSRamkumar Ramachandra
53d366c53eSRamkumar Ramachandra$ perf timechart
54d366c53eSRamkumar Ramachandra
55d366c53eSRamkumar Ramachandra  Written 10.2 seconds of trace to output.svg.
56d366c53eSRamkumar Ramachandra
5754874e32SStanislav Fomichev-n::
5854874e32SStanislav Fomichev--proc-num::
5954874e32SStanislav Fomichev        Print task info for at least given number of tasks.
6054874e32SStanislav Fomichev
61151750ceSArjan van de VenSEE ALSO
62151750ceSArjan van de Ven--------
63151750ceSArjan van de Venlinkperf:perf-record[1]
64