| Ingo Molnar | 0a02ad9 | 2009-09-11 12:12:54 +0200 | [diff] [blame] | 1 | perf-sched(1) | 
 | 2 | ============== | 
 | 3 |  | 
 | 4 | NAME | 
 | 5 | ---- | 
| Ingo Molnar | c13f0d3 | 2009-09-13 16:51:04 +0200 | [diff] [blame] | 6 | perf-sched - Tool to trace/measure scheduler properties (latencies) | 
| Ingo Molnar | 0a02ad9 | 2009-09-11 12:12:54 +0200 | [diff] [blame] | 7 |  | 
 | 8 | SYNOPSIS | 
 | 9 | -------- | 
 | 10 | [verse] | 
| Ingo Molnar | c13f0d3 | 2009-09-13 16:51:04 +0200 | [diff] [blame] | 11 | 'perf sched' {record|latency|replay|trace} | 
| Ingo Molnar | 0a02ad9 | 2009-09-11 12:12:54 +0200 | [diff] [blame] | 12 |  | 
 | 13 | DESCRIPTION | 
 | 14 | ----------- | 
| Randy Dunlap | 854c554 | 2010-03-31 11:31:00 -0700 | [diff] [blame] | 15 | There are four variants of perf sched: | 
| Ingo Molnar | c13f0d3 | 2009-09-13 16:51:04 +0200 | [diff] [blame] | 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 |  | 
 | 23 |   'perf sched trace' to see a detailed trace of the workload that | 
 | 24 |   was recorded. | 
 | 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) | 
| Randy Dunlap | 854c554 | 2010-03-31 11:31:00 -0700 | [diff] [blame] | 30 |   of the workload as it occurred when it was recorded - and can repeat | 
| Ingo Molnar | c13f0d3 | 2009-09-13 16:51:04 +0200 | [diff] [blame] | 31 |   it a number of times, measuring its performance.) | 
| Ingo Molnar | 0a02ad9 | 2009-09-11 12:12:54 +0200 | [diff] [blame] | 32 |  | 
 | 33 | OPTIONS | 
 | 34 | ------- | 
 | 35 | -D:: | 
 | 36 | --dump-raw-trace=:: | 
 | 37 |         Display verbose dump of the sched data. | 
 | 38 |  | 
 | 39 | SEE ALSO | 
 | 40 | -------- | 
 | 41 | linkperf:perf-record[1] |