Version:  2.0.40 2.2.26 2.4.37 3.0 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10 3.11 3.12 3.13 3.14 3.15 3.16

Linux/tools/perf/Documentation/perf-timechart.txt

  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]
 11 'perf timechart' [<timechart options>] {record} [<record options>]
 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 
 23 TIMECHART OPTIONS
 24 -----------------
 25 -o::
 26 --output=::
 27         Select the output file (default: output.svg)
 28 -i::
 29 --input=::
 30         Select the input file (default: perf.data unless stdin is a fifo)
 31 -w::
 32 --width=::
 33         Select the width of the SVG file (default: 1000)
 34 -P::
 35 --power-only::
 36         Only output the CPU power section of the diagram
 37 -T::
 38 --tasks-only::
 39         Don't output processor state transitions
 40 -p::
 41 --process::
 42         Select the processes to display, by name or PID
 43 
 44 --symfs=<directory>::
 45         Look for files with symbols relative to this directory.
 46 -n::
 47 --proc-num::
 48         Print task info for at least given number of tasks.
 49 -t::
 50 --topology::
 51         Sort CPUs according to topology.
 52 --highlight=<duration_nsecs|task_name>::
 53         Highlight tasks (using different color) that run more than given
 54         duration or tasks with given name. If number is given it's interpreted
 55         as number of nanoseconds. If non-numeric string is given it's
 56         interpreted as task name.
 57 
 58 RECORD OPTIONS
 59 --------------
 60 -P::
 61 --power-only::
 62         Record only power-related events
 63 -T::
 64 --tasks-only::
 65         Record only tasks-related events
 66 -g::
 67 --callchain::
 68         Do call-graph (stack chain/backtrace) recording
 69 
 70 EXAMPLES
 71 --------
 72 
 73 $ perf timechart record git pull
 74 
 75   [ perf record: Woken up 13 times to write data ]
 76   [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ]
 77 
 78 $ perf timechart
 79 
 80   Written 10.2 seconds of trace to output.svg.
 81 
 82 Record system-wide timechart:
 83 
 84   $ perf timechart record
 85 
 86   then generate timechart and highlight 'gcc' tasks:
 87 
 88   $ perf timechart --highlight gcc
 89 
 90 SEE ALSO
 91 --------
 92 linkperf:perf-record[1]

This page was automatically generated by LXR 0.3.1 (source).  •  Linux is a registered trademark of Linus Torvalds  •  Contact us