path: root/tools/perf/Documentation
diff options
authorNamhyung Kim <>2016-01-11 19:35:10 +0900
committerArnaldo Carvalho de Melo <>2016-01-12 12:42:07 -0300
commit09f1985404aa99b9d1ad435fcb0dabd20d4ed498 (patch)
treefd38588cac56184d3048a8c1b544002923d574ac /tools/perf/Documentation
parent6156681b73f2fffe56493e9a50518c0cbfcd8ba3 (diff)
perf tools: Add more usage tips
Thanks to Andi Kleen for providing useful tips. Suggested-by: Andi Kleen <> Signed-off-by: Namhyung Kim <> Cc: Andi Kleen <> Cc: Brendan Gregg <> Cc: David Ahern <> Cc: Jiri Olsa <> Cc: Peter Zijlstra <> Cc: Wang Nan <> Link: Signed-off-by: Arnaldo Carvalho de Melo <>
Diffstat (limited to 'tools/perf/Documentation')
1 files changed, 15 insertions, 0 deletions
diff --git a/tools/perf/Documentation/tips.txt b/tools/perf/Documentation/tips.txt
index a1c10e360db5..e0ce9573b79b 100644
--- a/tools/perf/Documentation/tips.txt
+++ b/tools/perf/Documentation/tips.txt
@@ -12,3 +12,18 @@ List events using substring match: perf list <keyword>
To see list of saved events and attributes: perf evlist -v
Use --symfs <dir> if your symbol files are in non-standard locations
To see callchains in a more compact form: perf report -g folded
+Show individual samples with: perf script
+Limit to show entries above 5% only: perf report --percent-limit 5
+Profiling branch (mis)predictions with: perf record -b / perf report
+Treat branches as callchains: perf report --branch-history
+To count events in every 1000 msec: perf stat -I 1000
+Print event counts in CSV format with: perf stat -x,
+If you have debuginfo enabled, try: perf report -s sym,srcline
+For memory address profiling, try: perf mem record / perf mem report
+For tracepoint events, try: perf report -s trace_fields
+To record callchains for each sample: perf record -g
+To record every process run by an user: perf record -u <user>
+Skip collecing build-id when recording: perf record -B
+To change sampling frequency to 100 Hz: perf record -F 100
+See assembly instructions with percentage: perf annotate <symbol>
+If you prefer Intel style assembly, try: perf annotate -M intel