'\" t
.\"     Title: perf-timechart
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 02/24/2016
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF_3.16\-TIMECHART" "1" "02/24/2016" "perf" "perf Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
perf-timechart \- Tool to visualize total system behavior during a workload
.SH "SYNOPSIS"
.sp
.nf
.fi
.SH "DESCRIPTION"
.sp
There are two variants of perf timechart:
.sp
.if n \{\
.RS 4
.\}
.nf
\*(Aqperf timechart record <command>\*(Aq to record the system level events
of an arbitrary workload\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\*(Aqperf timechart\*(Aq to turn a trace into a Scalable Vector Graphics file,
that can be viewed with popular SVG viewers such as \*(AqInkscape\*(Aq\&.
.fi
.if n \{\
.RE
.\}
.SH "TIMECHART OPTIONS"
.PP
\-o, \-\-output=
.RS 4
Select the output file (default: output\&.svg)
.RE
.PP
\-i, \-\-input=
.RS 4
Select the input file (default: perf\&.data unless stdin is a fifo)
.RE
.PP
\-w, \-\-width=
.RS 4
Select the width of the SVG file (default: 1000)
.RE
.PP
\-P, \-\-power\-only
.RS 4
Only output the CPU power section of the diagram
.RE
.PP
\-T, \-\-tasks\-only
.RS 4
Don\(cqt output processor state transitions
.RE
.PP
\-p, \-\-process
.RS 4
Select the processes to display, by name or PID
.RE
.PP
\-\-symfs=<directory>
.RS 4
Look for files with symbols relative to this directory\&.
.RE
.PP
\-n, \-\-proc\-num
.RS 4
Print task info for at least given number of tasks\&.
.RE
.PP
\-t, \-\-topology
.RS 4
Sort CPUs according to topology\&.
.RE
.PP
\-\-highlight=<duration_nsecs|task_name>
.RS 4
Highlight tasks (using different color) that run more than given duration or tasks with given name\&. If number is given it\(cqs interpreted as number of nanoseconds\&. If non\-numeric string is given it\(cqs interpreted as task name\&.
.RE
.SH "RECORD OPTIONS"
.PP
\-P, \-\-power\-only
.RS 4
Record only power\-related events
.RE
.PP
\-T, \-\-tasks\-only
.RS 4
Record only tasks\-related events
.RE
.PP
\-g, \-\-callchain
.RS 4
Do call\-graph (stack chain/backtrace) recording
.RE
.SH "EXAMPLES"
.sp
$ perf timechart record git pull
.sp
.if n \{\
.RS 4
.\}
.nf
[ perf record: Woken up 13 times to write data ]
[ perf record: Captured and wrote 4\&.253 MB perf\&.data (~185801 samples) ]
.fi
.if n \{\
.RE
.\}
.sp
$ perf timechart
.sp
.if n \{\
.RS 4
.\}
.nf
Written 10\&.2 seconds of trace to output\&.svg\&.
.fi
.if n \{\
.RE
.\}
.sp
Record system\-wide timechart:
.sp
.if n \{\
.RS 4
.\}
.nf
$ perf timechart record
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
then generate timechart and highlight \*(Aqgcc\*(Aq tasks:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ perf timechart \-\-highlight gcc
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.sp
\fBperf_3.16-record\fR(1)