summary refs log tree commit diff
path: root/tools/perf/Documentation
diff options
context:
space:
mode:
authorArnaldo Carvalho de Melo <acme@redhat.com>2021-03-15 11:27:24 -0300
committerArnaldo Carvalho de Melo <acme@redhat.com>2021-03-15 11:27:24 -0300
commit4a03af3ee399e87934e18ae720dda72c52f0050c (patch)
tree4a88f022e33217ee56798a08ca96ff30b88bd1fc /tools/perf/Documentation
parent5497b23e870c45486e8caf1116ccbb592443bff3 (diff)
downloadlinux-4a03af3ee399e87934e18ae720dda72c52f0050c.tar.gz
perf stat: Elaborate use cases for the -n/--null command line option
The existing text was way too terse, pick the intended usage from the
cset that introduced this option.

Twitter: https://twitter.com/_monoid/status/1371461130175004672?s=20
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
Diffstat (limited to 'tools/perf/Documentation')
-rw-r--r--tools/perf/Documentation/perf-stat.txt5
1 files changed, 4 insertions, 1 deletions
diff --git a/tools/perf/Documentation/perf-stat.txt b/tools/perf/Documentation/perf-stat.txt
index 08a1714494f8..3055aad38d46 100644
--- a/tools/perf/Documentation/perf-stat.txt
+++ b/tools/perf/Documentation/perf-stat.txt
@@ -142,7 +142,10 @@ Do not aggregate counts across all monitored CPUs.
 
 -n::
 --null::
-        null run - don't start any counters
+null run - Don't start any counters.
+
+This can be useful to measure just elapsed wall-clock time - or to assess the
+raw overhead of perf stat itself, without running any counters.
 
 -v::
 --verbose::