| 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] |
| Ramkumar Ramachandra | d366c53 | 2013-10-03 14:45:16 +0530 | [diff] [blame] | 11 | 'perf timechart' record <command> |
| 12 | 'perf timechart' [<options>] |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 13 | |
| 14 | DESCRIPTION |
| 15 | ----------- |
| 16 | There are two variants of perf timechart: |
| 17 | |
| 18 | 'perf timechart record <command>' to record the system level events |
| 19 | of an arbitrary workload. |
| 20 | |
| 21 | 'perf timechart' to turn a trace into a Scalable Vector Graphics file, |
| 22 | that can be viewed with popular SVG viewers such as 'Inkscape'. |
| 23 | |
| 24 | OPTIONS |
| 25 | ------- |
| 26 | -o:: |
| 27 | --output=:: |
| 28 | Select the output file (default: output.svg) |
| 29 | -i:: |
| 30 | --input=:: |
| Robert Richter | efad141 | 2011-12-07 10:02:54 +0100 | [diff] [blame] | 31 | 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] | 32 | -w:: |
| 33 | --width=:: |
| 34 | Select the width of the SVG file (default: 1000) |
| Arjan van de Ven | bbe2987 | 2009-10-20 07:09:39 +0900 | [diff] [blame] | 35 | -P:: |
| Arjan van de Ven | 39a90a8 | 2009-09-24 15:40:13 +0200 | [diff] [blame] | 36 | --power-only:: |
| 37 | Only output the CPU power section of the diagram |
| Arjan van de Ven | bbe2987 | 2009-10-20 07:09:39 +0900 | [diff] [blame] | 38 | -p:: |
| 39 | --process:: |
| 40 | Select the processes to display, by name or PID |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 41 | |
| David Ahern | ec5761e | 2010-12-09 13:27:07 -0700 | [diff] [blame] | 42 | --symfs=<directory>:: |
| 43 | Look for files with symbols relative to this directory. |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 44 | |
| Ramkumar Ramachandra | d366c53 | 2013-10-03 14:45:16 +0530 | [diff] [blame] | 45 | EXAMPLES |
| 46 | -------- |
| 47 | |
| 48 | $ perf timechart record git pull |
| 49 | |
| 50 | [ perf record: Woken up 13 times to write data ] |
| 51 | [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ] |
| 52 | |
| 53 | $ perf timechart |
| 54 | |
| 55 | Written 10.2 seconds of trace to output.svg. |
| 56 | |
| Arjan van de Ven | 151750c | 2009-09-19 13:36:04 +0200 | [diff] [blame] | 57 | SEE ALSO |
| 58 | -------- |
| 59 | linkperf:perf-record[1] |