perf/Documentation/perf-sched.txt

1 perf-sched(1)
5 ----
6 perf-sched - Tool to trace/measure scheduler properties (latencies)
9 --------
14 -----------
24        perf sched record -- sleep 1
27 …--------------------------------------------------------------------------------------------------…
28 …         |   Runtime ms  |  Count   | Avg delay ms    | Max delay ms    | Max delay start         …
29 …--------------------------------------------------------------------------------------------------…
32 …kworker/1:2-xfs:4649  |      0.012 ms |        1 | avg:   0.008 ms | max:   0.008 ms | max start: …
33 …kworker/3:1-xfs:388   |      0.011 ms |        1 | avg:   0.006 ms | max:   0.006 ms | max start: …
37   Count(number of times a delay was calculated) and delay(time that a
41   given within (), However if -p option is used, pid is mentioned.
50   of the workload as it occurred when it was recorded - and can repeat
53   'perf sched map' to print a textual context-switching outline of
55   individual CPUs, and the two-letter shortcuts stand for tasks that
57   a dot signals an idle CPU.
62         perf sched record -- sleep 1
65    By default it shows the individual schedule events, including the wait
66    time (time between sched-out and next sched-in events for the task), the
67    task scheduling delay (time between runnable and actually running) and
70                 time    cpu  task name             wait time  sch delay   run time
72       -------------- ------  --------------------  ---------  ---------  ---------
76         79371.874604 [0011]  <idle>                    1.148      0.000      0.035
77         79371.874723 [0005]  <idle>                    0.016      0.000      1.383
84 -------
85 -i::
86 --input=<file>::
89 -v::
90 --verbose::
93 -D::
94 --dump-raw-trace=::
97 -f::
98 --force::
102 -------------------------------
104 -C::
105 --CPU <n>::
108 -p::
109 --pids::
112 -s::
113 --sort <key[,key2...]>::
118 ----------------------------
120 --compact::
124 --cpus::
127 --color-cpus::
130 --color-pids::
133 --task-name <task>::
135 	task names with a comma (without whitespace). The sched-out
136 	time is printed and is represented by '*-' for the given
138 	('-' indicates other tasks while '.' is idle).
140 --fuzzy-name::
144 ---------------------------------
145 -k::
146 --vmlinux=<file>::
149 --kallsyms=<file>::
152 -g::
153 --call-graph::
156 --max-stack::
159 -C=::
160 --cpu=::
163 -p=::
164 --pid=::
167 -t=::
168 --tid=::
171 -s::
172 --summary::
176 -S::
177 --with-summary::
181 --symfs=<directory>::
184 -V::
185 --cpu-visual::
186 	Show visual aid for sched switches by CPU: 'i' marks idle time,
189 -w::
190 --wakeups::
193 -M::
194 --migrations::
197 -n::
198 --next::
201 -I::
202 --idle-hist::
203 	Show idle-related events only.
205 --time::
212 --state::
215 --show-prio::
218 --prio::
220 	provided as a comma-separated list with no spaces: 0,120. Ranges of
221 	priorities are specified with -: 120-129. A combination of both can also be
222 	provided: 0,120-129.
225 ------------------------------
227 -r::
228 --repeat <n>::
232 --------
233 linkperf:perf-record[1]