path: root/tools/perf/Documentation/perf-top.txt
diff options
authorIngo Molnar <>2009-06-06 20:33:43 +0200
committerIngo Molnar <>2009-06-06 20:33:43 +0200
commit864709302a80f26fa9da3be5b47304f0b8bae192 (patch)
tree8c2bab78f141fe43a38914bd3e3aae0a88f958e5 /tools/perf/Documentation/perf-top.txt
parent75b5032212641f6d38ac041416945e70da833b68 (diff)
perf_counter tools: Move from Documentation/perf_counter/ to tools/perf/
Several people have suggested that 'perf' has become a full-fledged tool that should be moved out of Documentation/. Move it to the (new) tools/ directory. Cc: Peter Zijlstra <> Cc: Mike Galbraith <> Cc: Paul Mackerras <> Cc: Arnaldo Carvalho de Melo <> LKML-Reference: <new-submission> Signed-off-by: Ingo Molnar <>
Diffstat (limited to 'tools/perf/Documentation/perf-top.txt')
1 files changed, 39 insertions, 0 deletions
diff --git a/tools/perf/Documentation/perf-top.txt b/tools/perf/Documentation/perf-top.txt
new file mode 100644
index 000000000000..539d01289725
--- /dev/null
+++ b/tools/perf/Documentation/perf-top.txt
@@ -0,0 +1,39 @@
+perf-top - Run a command and profile it
+'perf top' [-e <EVENT> | --event=EVENT] [-l] [-a] <command>
+This command runs a command and gathers a performance counter profile
+from it.
+ Any command you can specify in a shell.
+ Select the PMU event. Selection can be a symbolic event name
+ (use 'perf list' to list all events) or a raw PMU
+ event (eventsel+umask) in the form of rNNN where NNN is a
+ hexadecimal event descriptor.
+ system-wide collection
+ scale counter values
+linkperf:perf-stat[1], linkperf:perf-list[1]