| Ingo Molnar | 1d8c8b2 | 2009-04-20 15:52:29 +0200 | [diff] [blame] | 1 | perf-top(1) |
| Ingo Molnar | 6e6b754 | 2008-04-15 22:39:31 +0200 | [diff] [blame] | 2 | =========== |
| Ingo Molnar | 1d8c8b2 | 2009-04-20 15:52:29 +0200 | [diff] [blame] | 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | perf-top - Run a command and profile it |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| 11 | 'perf top' [-e <EVENT> | --event=EVENT] [-l] [-a] <command> |
| 12 | |
| 13 | DESCRIPTION |
| 14 | ----------- |
| 15 | This command runs a command and gathers a performance counter profile |
| 16 | from it. |
| 17 | |
| 18 | |
| 19 | OPTIONS |
| 20 | ------- |
| 21 | <command>...:: |
| 22 | Any command you can specify in a shell. |
| 23 | |
| 24 | -e:: |
| 25 | --event=:: |
| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 26 | Select the PMU event. Selection can be a symbolic event name |
| 27 | (use 'perf list' to list all events) or a raw PMU |
| 28 | event (eventsel+umask) in the form of rNNN where NNN is a |
| 29 | hexadecimal event descriptor. |
| Ingo Molnar | 1d8c8b2 | 2009-04-20 15:52:29 +0200 | [diff] [blame] | 30 | |
| 31 | -a:: |
| 32 | system-wide collection |
| 33 | |
| 34 | -l:: |
| 35 | scale counter values |
| 36 | |
| Ingo Molnar | 1d8c8b2 | 2009-04-20 15:52:29 +0200 | [diff] [blame] | 37 | SEE ALSO |
| 38 | -------- |
| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 39 | linkperf:perf-stat[1], linkperf:perf-list[1] |