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] 11367b3152SStanislav Fomichev'perf timechart' [<timechart options>] {record} [<record options>] 12151750ceSArjan van de Ven 13151750ceSArjan van de VenDESCRIPTION 14151750ceSArjan van de Ven----------- 15151750ceSArjan van de VenThere are two variants of perf timechart: 16151750ceSArjan van de Ven 17151750ceSArjan van de Ven 'perf timechart record <command>' to record the system level events 18151750ceSArjan van de Ven of an arbitrary workload. 19151750ceSArjan van de Ven 20151750ceSArjan van de Ven 'perf timechart' to turn a trace into a Scalable Vector Graphics file, 21151750ceSArjan van de Ven that can be viewed with popular SVG viewers such as 'Inkscape'. 22151750ceSArjan van de Ven 23367b3152SStanislav FomichevTIMECHART OPTIONS 24367b3152SStanislav Fomichev----------------- 25151750ceSArjan van de Ven-o:: 26151750ceSArjan van de Ven--output=:: 27151750ceSArjan van de Ven Select the output file (default: output.svg) 28151750ceSArjan van de Ven-i:: 29151750ceSArjan van de Ven--input=:: 30efad1415SRobert Richter Select the input file (default: perf.data unless stdin is a fifo) 315094b655SArjan van de Ven-w:: 325094b655SArjan van de Ven--width=:: 335094b655SArjan van de Ven Select the width of the SVG file (default: 1000) 34bbe2987bSArjan van de Ven-P:: 3539a90a8eSArjan van de Ven--power-only:: 3639a90a8eSArjan van de Ven Only output the CPU power section of the diagram 37c87097d3SStanislav Fomichev-T:: 38c87097d3SStanislav Fomichev--tasks-only:: 39c87097d3SStanislav Fomichev Don't output processor state transitions 40bbe2987bSArjan van de Ven-p:: 41bbe2987bSArjan van de Ven--process:: 42bbe2987bSArjan van de Ven Select the processes to display, by name or PID 43151750ceSArjan van de Ven 44ec5761eaSDavid Ahern--symfs=<directory>:: 45ec5761eaSDavid Ahern Look for files with symbols relative to this directory. 46151750ceSArjan van de Ven 47d366c53eSRamkumar RamachandraEXAMPLES 48d366c53eSRamkumar Ramachandra-------- 49d366c53eSRamkumar Ramachandra 50d366c53eSRamkumar Ramachandra$ perf timechart record git pull 51d366c53eSRamkumar Ramachandra 52d366c53eSRamkumar Ramachandra [ perf record: Woken up 13 times to write data ] 53d366c53eSRamkumar Ramachandra [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ] 54d366c53eSRamkumar Ramachandra 55d366c53eSRamkumar Ramachandra$ perf timechart 56d366c53eSRamkumar Ramachandra 57d366c53eSRamkumar Ramachandra Written 10.2 seconds of trace to output.svg. 58d366c53eSRamkumar Ramachandra 5954874e32SStanislav Fomichev-n:: 6054874e32SStanislav Fomichev--proc-num:: 6154874e32SStanislav Fomichev Print task info for at least given number of tasks. 62*c5079997SStanislav Fomichev-t:: 63*c5079997SStanislav Fomichev--topology:: 64*c5079997SStanislav Fomichev Sort CPUs according to topology. 6554874e32SStanislav Fomichev 66367b3152SStanislav FomichevRECORD OPTIONS 67367b3152SStanislav Fomichev-------------- 68367b3152SStanislav Fomichev-P:: 69367b3152SStanislav Fomichev--power-only:: 70367b3152SStanislav Fomichev Record only power-related events 71367b3152SStanislav Fomichev-T:: 72367b3152SStanislav Fomichev--tasks-only:: 73367b3152SStanislav Fomichev Record only tasks-related events 746f8d67faSStanislav Fomichev-g:: 756f8d67faSStanislav Fomichev--callchain:: 766f8d67faSStanislav Fomichev Do call-graph (stack chain/backtrace) recording 77367b3152SStanislav Fomichev 78151750ceSArjan van de VenSEE ALSO 79151750ceSArjan van de Ven-------- 80151750ceSArjan van de Venlinkperf:perf-record[1] 81