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' record <command>
  12 'perf timechart' [<options>]
  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=::
  31         Select the input file (default: perf.data unless stdin is a fifo)
  32 -w::
  33 --width=::
  34         Select the width of the SVG file (default: 1000)
  35 -P::
  36 --power-only::
  37         Only output the CPU power section of the diagram
  38 -p::
  39 --process::
  40         Select the processes to display, by name or PID
  41
  42 --symfs=<directory>::
  43         Look for files with symbols relative to this directory.
  44
  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
  57 SEE ALSO
  58 --------
  59 linkperf:perf-record[1]