Version:  2.0.40 2.2.26 2.4.37 2.6.39 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

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 
 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 
 59 Record system-wide timechart:
 60 
 61   $ perf timechart record
 62 
 63   then generate timechart and highlight 'gcc' tasks:
 64 
 65   $ perf timechart --highlight gcc
 66 
 67 -n::
 68 --proc-num::
 69         Print task info for at least given number of tasks.
 70 -t::
 71 --topology::
 72         Sort CPUs according to topology.
 73 --highlight=<duration_nsecs|task_name>::
 74         Highlight tasks (using different color) that run more than given
 75         duration or tasks with given name. If number is given it's interpreted
 76         as number of nanoseconds. If non-numeric string is given it's
 77         interpreted as task name.
 78 
 79 RECORD OPTIONS
 80 --------------
 81 -P::
 82 --power-only::
 83         Record only power-related events
 84 -T::
 85 --tasks-only::
 86         Record only tasks-related events
 87 -g::
 88 --callchain::
 89         Do call-graph (stack chain/backtrace) recording
 90 
 91 SEE ALSO
 92 --------
 93 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