path: root/tools/perf/Documentation/perf-list.txt
diff options
authorArnaldo Carvalho de Melo <>2011-02-17 15:38:58 -0200
committerArnaldo Carvalho de Melo <>2011-02-17 15:38:58 -0200
commit668b8788f497b2386402daeca583d6300240d41d (patch)
tree7e931ce5240c6a13b29510a854f90f07dc4629c5 /tools/perf/Documentation/perf-list.txt
parent74cfc17dc1a69c37ce6c8a76c1ce84bcb796eb0e (diff)
perf list: Allow filtering list of events
The man page has the details, here are some examples: [root@emilia ~]# perf list *fault* *:*wait* List of pre-defined events (to be used in -e): page-faults OR faults [Software event] minor-faults [Software event] major-faults [Software event] alignment-faults [Software event] emulation-faults [Software event] radeon:radeon_fence_wait_begin [Tracepoint event] radeon:radeon_fence_wait_end [Tracepoint event] writeback:wbc_writeback_wait [Tracepoint event] writeback:wbc_balance_dirty_wait [Tracepoint event] writeback:writeback_congestion_wait [Tracepoint event] writeback:writeback_wait_iff_congested [Tracepoint event] sched:sched_wait_task [Tracepoint event] sched:sched_process_wait [Tracepoint event] sched:sched_stat_wait [Tracepoint event] sched:sched_stat_iowait [Tracepoint event] syscalls:sys_enter_epoll_wait [Tracepoint event] syscalls:sys_exit_epoll_wait [Tracepoint event] syscalls:sys_enter_epoll_pwait [Tracepoint event] syscalls:sys_exit_epoll_pwait [Tracepoint event] syscalls:sys_enter_rt_sigtimedwait [Tracepoint event] syscalls:sys_exit_rt_sigtimedwait [Tracepoint event] syscalls:sys_enter_waitid [Tracepoint event] syscalls:sys_exit_waitid [Tracepoint event] syscalls:sys_enter_wait4 [Tracepoint event] syscalls:sys_exit_wait4 [Tracepoint event] syscalls:sys_enter_waitpid [Tracepoint event] syscalls:sys_exit_waitpid [Tracepoint event] [root@emilia ~]# Suggested-by: Ingo Molnar <> Cc: Frederic Weisbecker <> Cc: Ingo Molnar <> Cc: Mike Galbraith <> Cc: Paul Mackerras <> Cc: Peter Zijlstra <> Cc: Stephane Eranian <> Cc: Tom Zanussi <> LKML-Reference: <new-submission> Signed-off-by: Arnaldo Carvalho de Melo <>
Diffstat (limited to 'tools/perf/Documentation/perf-list.txt')
1 files changed, 21 insertions, 2 deletions
diff --git a/tools/perf/Documentation/perf-list.txt b/tools/perf/Documentation/perf-list.txt
index 399751befeed..7a527f7e9da9 100644
--- a/tools/perf/Documentation/perf-list.txt
+++ b/tools/perf/Documentation/perf-list.txt
@@ -8,7 +8,7 @@ perf-list - List all symbolic event types
-'perf list'
+'perf list' [hw|sw|cache|tracepoint|event_glob]
@@ -63,7 +63,26 @@ details. Some of them are referenced in the SEE ALSO section below.
+Without options all known events will be listed.
+To limit the list use:
+. 'hw' or 'hardware' to list hardware events such as cache-misses, etc.
+. 'sw' or 'software' to list software events such as context switches, etc.
+. 'cache' or 'hwcache' to list hardware cache events such as L1-dcache-loads, etc.
+. 'tracepoint' to list all tracepoint events, alternatively use
+ 'subsys_glob:event_glob' to filter by tracepoint subsystems such as sched,
+ block, etc.
+. If none of the above is matched, it will apply the supplied glob to all
+ events, printing the ones that match.
+One or more types can be used at the same time, listing the events for the
+types specified.