github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-11-07 06:17:02 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

perf stat: Document task-clock/cpu-clock in TIMINGS

Browse Source 
task-clock/cpu-clock appear in perf stat's own example output but were
never explained in perf-stat.txt, unlike time elapsed/user/sys.  This
came up unanswered on the list in 2013 and 2015 without docs ever being
added.

Reviewed-by: Ian Rogers <irogers@google.com>
Signed-off-by: Christian Melendez <chrismelnu@gmail.com>
Link: https://lore.kernel.org/all/arWi_dY4y15J2rqh@google.com ]
[ Removed the :u modifier from the task-clock example, per Namhyung request ]
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
This commit is contained in:
Christian Melendez 2026-09-23 15:51:40 +02:00 committed by Arnaldo Carvalho de Melo
parent dd0b7ec38d
commit d6f751c7ad
1 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
tools/perf/Documentation/perf-stat.txt
View File

@ -621,6 +621,16 @@ user/system lands:
Those times are the very same as displayed by the 'time' tool.
We also display a clock-based timing metric that depends on the
target being monitored:
83723.452481 task-clock (msec) # 1.004 CPUs utilized
For a single task, task-clock reports a clock count specific to that
task. When the target is a CPU or the whole system (-a or -C),
cpu-clock is reported instead. cpu-clock is a high-resolution per-CPU
timer. See perf_event_open(2) for more details.
CSV FORMAT
----------
@ -671,4 +681,4 @@ that can be used for parsing.
SEE ALSO
--------
linkperf:perf-top[1], linkperf:perf-list[1]
linkperf:perf-top[1], linkperf:perf-list[1], perf_event_open(2)