aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Gleixner <tglx@linutronix.de>2009-06-06 14:56:33 +0200
committerIngo Molnar <mingo@elte.hu>2009-06-06 15:23:49 +0200
commit386b05e3a2f3c5b0a9c5575060421cca0911648a (patch)
treeb45cbf51442943e24ddca84f19d53a83ba49cf4a
parent8faf3b547593bf6ea10df631e73204975273c4e0 (diff)
perf_counter tools: Add help for perf list
Also update other areas of the help texts. Signed-off-by: Thomas Gleixner <tglx@linutronix.de> Cc: Peter Zijlstra <a.p.zijlstra@chello.nl> Cc: Mike Galbraith <efault@gmx.de> Cc: Paul Mackerras <paulus@samba.org> Cc: Arnaldo Carvalho de Melo <acme@redhat.com> LKML-Reference: <new-submission> Signed-off-by: Ingo Molnar <mingo@elte.hu>
-rw-r--r--Documentation/perf_counter/Documentation/perf-list.txt25
-rw-r--r--Documentation/perf_counter/Documentation/perf-record.txt26
-rw-r--r--Documentation/perf_counter/Documentation/perf-stat.txt26
-rw-r--r--Documentation/perf_counter/Documentation/perf-top.txt26
-rw-r--r--Documentation/perf_counter/Documentation/perf.txt3
5 files changed, 42 insertions, 64 deletions
diff --git a/Documentation/perf_counter/Documentation/perf-list.txt b/Documentation/perf_counter/Documentation/perf-list.txt
new file mode 100644
index 00000000000..aa55a71184f
--- /dev/null
+++ b/Documentation/perf_counter/Documentation/perf-list.txt
@@ -0,0 +1,25 @@
+perf-list(1)
+==============
+
+NAME
+----
+perf-list - List all symbolic event types
+
+SYNOPSIS
+--------
+[verse]
+'perf list
+
+DESCRIPTION
+-----------
+This command displays the symbolic event types which can be selected in the
+various perf commands with the -e option.
+
+OPTIONS
+-------
+None
+
+SEE ALSO
+--------
+linkperf:perf-stat[1], linkperf:perf-top[1],
+linkperf:perf-record[1]
diff --git a/Documentation/perf_counter/Documentation/perf-record.txt b/Documentation/perf_counter/Documentation/perf-record.txt
index 4d3416fc764..1dbc1eeb4c0 100644
--- a/Documentation/perf_counter/Documentation/perf-record.txt
+++ b/Documentation/perf_counter/Documentation/perf-record.txt
@@ -26,26 +26,10 @@ OPTIONS
-e::
--event=::
- 0:0: cpu-cycles
- 0:0: cycles
- 0:1: instructions
- 0:2: cache-references
- 0:3: cache-misses
- 0:4: branch-instructions
- 0:4: branches
- 0:5: branch-misses
- 0:6: bus-cycles
- 1:0: cpu-clock
- 1:1: task-clock
- 1:2: page-faults
- 1:2: faults
- 1:5: minor-faults
- 1:6: major-faults
- 1:3: context-switches
- 1:3: cs
- 1:4: cpu-migrations
- 1:4: migrations
- rNNN: raw PMU events (eventsel+umask)
+ 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.
-a::
system-wide collection
@@ -55,4 +39,4 @@ OPTIONS
SEE ALSO
--------
-linkperf:perf-stat[1]
+linkperf:perf-stat[1], linkperf:perf-list[1]
diff --git a/Documentation/perf_counter/Documentation/perf-stat.txt b/Documentation/perf_counter/Documentation/perf-stat.txt
index a340e7be83d..5d95784cce4 100644
--- a/Documentation/perf_counter/Documentation/perf-stat.txt
+++ b/Documentation/perf_counter/Documentation/perf-stat.txt
@@ -25,26 +25,10 @@ OPTIONS
-e::
--event=::
- 0:0: cpu-cycles
- 0:0: cycles
- 0:1: instructions
- 0:2: cache-references
- 0:3: cache-misses
- 0:4: branch-instructions
- 0:4: branches
- 0:5: branch-misses
- 0:6: bus-cycles
- 1:0: cpu-clock
- 1:1: task-clock
- 1:2: page-faults
- 1:2: faults
- 1:5: minor-faults
- 1:6: major-faults
- 1:3: context-switches
- 1:3: cs
- 1:4: cpu-migrations
- 1:4: migrations
- rNNN: raw PMU events (eventsel+umask)
+ 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.
-i::
--inherit::
@@ -79,4 +63,4 @@ $ perf stat -- make -j
SEE ALSO
--------
-linkperf:perf-tops[1]
+linkperf:perf-top[1], linkperf:perf-list[1]
diff --git a/Documentation/perf_counter/Documentation/perf-top.txt b/Documentation/perf_counter/Documentation/perf-top.txt
index 15251e40e4f..c8eb7cfffcd 100644
--- a/Documentation/perf_counter/Documentation/perf-top.txt
+++ b/Documentation/perf_counter/Documentation/perf-top.txt
@@ -23,26 +23,10 @@ OPTIONS
-e::
--event=::
- 0:0: cpu-cycles
- 0:0: cycles
- 0:1: instructions
- 0:2: cache-references
- 0:3: cache-misses
- 0:4: branch-instructions
- 0:4: branches
- 0:5: branch-misses
- 0:6: bus-cycles
- 1:0: cpu-clock
- 1:1: task-clock
- 1:2: page-faults
- 1:2: faults
- 1:5: minor-faults
- 1:6: major-faults
- 1:3: context-switches
- 1:3: cs
- 1:4: cpu-migrations
- 1:4: migrations
- rNNN: raw PMU events (eventsel+umask)
+ 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.
-a::
system-wide collection
@@ -52,4 +36,4 @@ OPTIONS
SEE ALSO
--------
-linkperf:perf-stat[1]
+linkperf:perf-stat[1], linkperf:perf-list[1]
diff --git a/Documentation/perf_counter/Documentation/perf.txt b/Documentation/perf_counter/Documentation/perf.txt
index e3d8b3832c6..69c83255719 100644
--- a/Documentation/perf_counter/Documentation/perf.txt
+++ b/Documentation/perf_counter/Documentation/perf.txt
@@ -20,4 +20,5 @@ and software features (software counters, tracepoints) as well.
SEE ALSO
--------
linkperf:perf-stat[1], linkperf:perf-top[1],
-linkperf:perf-record[1], linkperf:perf-report[1]
+linkperf:perf-record[1], linkperf:perf-report[1],
+linkperf:perf-list[1]