| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 1 | perf-timechart(1) |
| 2 | ================= |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | perf-timechart - Tool to visualize total system behavior during a workload |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| Stanislav Fomichev | 367b315 | 2013-11-01 20:25:50 +0400 | [diff] [blame^] | 11 | 'perf timechart' [<timechart options>] {record} [<record options>] |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 12 | |
| 13 | DESCRIPTION |
| 14 | ----------- |
| 15 | There 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 | |
| Stanislav Fomichev | 367b315 | 2013-11-01 20:25:50 +0400 | [diff] [blame^] | 23 | TIMECHART OPTIONS |
| 24 | ----------------- |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 25 | -o:: |
| 26 | --output=:: |
| 27 | Select the output file (default: output.svg) |
| 28 | -i:: |
| 29 | --input=:: |
| Robert Richter | efad141 | 2011-12-07 10:02:54 +0100 | [diff] [blame] | 30 | Select the input file (default: perf.data unless stdin is a fifo) |
| Arjan van de Ven | 5094b65 | 2009-09-20 18:14:16 +0200 | [diff] [blame] | 31 | -w:: |
| 32 | --width=:: |
| 33 | Select the width of the SVG file (default: 1000) |
| Arjan van de Ven | bbe2987 | 2009-10-20 07:09:39 +0900 | [diff] [blame] | 34 | -P:: |
| Arjan van de Ven | 39a90a8 | 2009-09-24 15:40:13 +0200 | [diff] [blame] | 35 | --power-only:: |
| 36 | Only output the CPU power section of the diagram |
| Stanislav Fomichev | c87097d | 2013-11-01 20:25:48 +0400 | [diff] [blame] | 37 | -T:: |
| 38 | --tasks-only:: |
| 39 | Don't output processor state transitions |
| Arjan van de Ven | bbe2987 | 2009-10-20 07:09:39 +0900 | [diff] [blame] | 40 | -p:: |
| 41 | --process:: |
| 42 | Select the processes to display, by name or PID |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 43 | |
| David Ahern | ec5761e | 2010-12-09 13:27:07 -0700 | [diff] [blame] | 44 | --symfs=<directory>:: |
| 45 | Look for files with symbols relative to this directory. |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 46 | |
| Ramkumar Ramachandra | d366c53 | 2013-10-03 14:45:16 +0530 | [diff] [blame] | 47 | EXAMPLES |
| 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 | |
| Stanislav Fomichev | 54874e3 | 2013-11-01 20:25:46 +0400 | [diff] [blame] | 59 | -n:: |
| 60 | --proc-num:: |
| 61 | Print task info for at least given number of tasks. |
| 62 | |
| Stanislav Fomichev | 367b315 | 2013-11-01 20:25:50 +0400 | [diff] [blame^] | 63 | RECORD OPTIONS |
| 64 | -------------- |
| 65 | -P:: |
| 66 | --power-only:: |
| 67 | Record only power-related events |
| 68 | -T:: |
| 69 | --tasks-only:: |
| 70 | Record only tasks-related events |
| 71 | |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 72 | SEE ALSO |
| 73 | -------- |
| 74 | linkperf:perf-record[1] |