2009-09-11 04:12:54 -06:00
|
|
|
perf-sched(1)
|
|
|
|
==============
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2009-09-13 08:51:04 -06:00
|
|
|
perf-sched - Tool to trace/measure scheduler properties (latencies)
|
2009-09-11 04:12:54 -06:00
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
[verse]
|
2011-09-27 03:16:35 -06:00
|
|
|
'perf sched' {record|latency|map|replay|script}
|
2009-09-11 04:12:54 -06:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2010-11-30 18:57:18 -07:00
|
|
|
There are five variants of perf sched:
|
2009-09-13 08:51:04 -06:00
|
|
|
|
|
|
|
'perf sched record <command>' to record the scheduling events
|
|
|
|
of an arbitrary workload.
|
|
|
|
|
|
|
|
'perf sched latency' to report the per task scheduling latencies
|
|
|
|
and other scheduling properties of the workload.
|
|
|
|
|
2011-09-27 03:16:35 -06:00
|
|
|
'perf sched script' to see a detailed trace of the workload that
|
|
|
|
was recorded (aliased to 'perf script' for now).
|
2009-09-13 08:51:04 -06:00
|
|
|
|
|
|
|
'perf sched replay' to simulate the workload that was recorded
|
|
|
|
via perf sched record. (this is done by starting up mockup threads
|
|
|
|
that mimic the workload based on the events in the trace. These
|
|
|
|
threads can then replay the timings (CPU runtime and sleep patterns)
|
2010-03-31 12:31:00 -06:00
|
|
|
of the workload as it occurred when it was recorded - and can repeat
|
2009-09-13 08:51:04 -06:00
|
|
|
it a number of times, measuring its performance.)
|
2009-09-11 04:12:54 -06:00
|
|
|
|
2010-11-30 18:57:18 -07:00
|
|
|
'perf sched map' to print a textual context-switching outline of
|
|
|
|
workload captured via perf sched record. Columns stand for
|
|
|
|
individual CPUs, and the two-letter shortcuts stand for tasks that
|
|
|
|
are running on a CPU. A '*' denotes the CPU that had the event, and
|
|
|
|
a dot signals an idle CPU.
|
|
|
|
|
2009-09-11 04:12:54 -06:00
|
|
|
OPTIONS
|
|
|
|
-------
|
2010-11-30 18:57:18 -07:00
|
|
|
-i::
|
|
|
|
--input=<file>::
|
2011-12-07 02:02:54 -07:00
|
|
|
Input file name. (default: perf.data unless stdin is a fifo)
|
2010-11-30 18:57:18 -07:00
|
|
|
|
|
|
|
-v::
|
|
|
|
--verbose::
|
|
|
|
Be more verbose. (show symbol address, etc)
|
|
|
|
|
2009-09-11 04:12:54 -06:00
|
|
|
-D::
|
|
|
|
--dump-raw-trace=::
|
|
|
|
Display verbose dump of the sched data.
|
|
|
|
|
2016-04-12 07:29:26 -06:00
|
|
|
OPTIONS for 'perf sched map'
|
|
|
|
----------------------------
|
|
|
|
|
|
|
|
--compact::
|
|
|
|
Show only CPUs with activity. Helps visualizing on high core
|
|
|
|
count systems.
|
|
|
|
|
2016-04-12 07:29:31 -06:00
|
|
|
--cpus::
|
|
|
|
Show just entries with activities for the given CPUs.
|
|
|
|
|
2016-04-12 07:29:30 -06:00
|
|
|
--color-cpus::
|
|
|
|
Highlight the given cpus.
|
|
|
|
|
2016-04-12 07:29:29 -06:00
|
|
|
--color-pids::
|
|
|
|
Highlight the given pids.
|
|
|
|
|
2009-09-11 04:12:54 -06:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
|
|
|
linkperf:perf-record[1]
|