Commit | Line | Data |
---|---|---|
0a02ad93 IM |
1 | perf-sched(1) |
2 | ============== | |
3 | ||
4 | NAME | |
5 | ---- | |
c13f0d3c | 6 | perf-sched - Tool to trace/measure scheduler properties (latencies) |
0a02ad93 IM |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
10 | [verse] | |
e78cb362 | 11 | 'perf sched' {record|latency|map|replay|script} |
0a02ad93 IM |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
1eacc94a | 15 | There are five variants of perf sched: |
c13f0d3c IM |
16 | |
17 | 'perf sched record <command>' to record the scheduling events | |
18 | of an arbitrary workload. | |
19 | ||
20 | 'perf sched latency' to report the per task scheduling latencies | |
21 | and other scheduling properties of the workload. | |
22 | ||
e78cb362 JO |
23 | 'perf sched script' to see a detailed trace of the workload that |
24 | was recorded (aliased to 'perf script' for now). | |
c13f0d3c IM |
25 | |
26 | 'perf sched replay' to simulate the workload that was recorded | |
27 | via perf sched record. (this is done by starting up mockup threads | |
28 | that mimic the workload based on the events in the trace. These | |
29 | threads can then replay the timings (CPU runtime and sleep patterns) | |
854c5548 | 30 | of the workload as it occurred when it was recorded - and can repeat |
c13f0d3c | 31 | it a number of times, measuring its performance.) |
0a02ad93 | 32 | |
1eacc94a SB |
33 | 'perf sched map' to print a textual context-switching outline of |
34 | workload captured via perf sched record. Columns stand for | |
35 | individual CPUs, and the two-letter shortcuts stand for tasks that | |
36 | are running on a CPU. A '*' denotes the CPU that had the event, and | |
37 | a dot signals an idle CPU. | |
38 | ||
0a02ad93 IM |
39 | OPTIONS |
40 | ------- | |
1eacc94a SB |
41 | -i:: |
42 | --input=<file>:: | |
efad1415 | 43 | Input file name. (default: perf.data unless stdin is a fifo) |
1eacc94a SB |
44 | |
45 | -v:: | |
46 | --verbose:: | |
47 | Be more verbose. (show symbol address, etc) | |
48 | ||
0a02ad93 IM |
49 | -D:: |
50 | --dump-raw-trace=:: | |
51 | Display verbose dump of the sched data. | |
52 | ||
53 | SEE ALSO | |
54 | -------- | |
55 | linkperf:perf-record[1] |