| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 1 | perf-list(1) |
| Ingo Molnar | 6e6b754 | 2008-04-15 22:39:31 +0200 | [diff] [blame] | 2 | ============ |
| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | perf-list - List all symbolic event types |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| Ingo Molnar | 6e6b754 | 2008-04-15 22:39:31 +0200 | [diff] [blame] | 11 | 'perf list' |
| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 12 | |
| 13 | DESCRIPTION |
| 14 | ----------- |
| 15 | This command displays the symbolic event types which can be selected in the |
| 16 | various perf commands with the -e option. |
| 17 | |
| Arnaldo Carvalho de Melo | 9e32a3c | 2010-05-05 11:20:05 -0300 | [diff] [blame] | 18 | RAW HARDWARE EVENT DESCRIPTOR |
| 19 | ----------------------------- |
| 20 | Even when an event is not available in a symbolic form within perf right now, |
| Arnaldo Carvalho de Melo | 1cf4a06 | 2010-05-07 14:07:05 -0300 | [diff] [blame^] | 21 | it can be encoded in a per processor specific way. |
| 22 | |
| 23 | For instance For x86 CPUs NNN represents the raw register encoding with the |
| 24 | layout of IA32_PERFEVTSELx MSRs (see [Intel® 64 and IA-32 Architectures Software Developer's Manual Volume 3B: System Programming Guide] Figure 30-1 Layout |
| 25 | of IA32_PERFEVTSELx MSRs) or AMD's PerfEvtSeln (see [AMD64 Architecture Programmer’s Manual Volume 2: System Programming], Page 344, |
| 26 | Figure 13-7 Performance Event-Select Register (PerfEvtSeln)). |
| 27 | |
| 28 | Example: |
| 29 | |
| 30 | If the Intel docs for a QM720 Core i7 describe an event as: |
| Arnaldo Carvalho de Melo | 9e32a3c | 2010-05-05 11:20:05 -0300 | [diff] [blame] | 31 | |
| 32 | Event Umask Event Mask |
| 33 | Num. Value Mnemonic Description Comment |
| 34 | |
| 35 | A8H 01H LSD.UOPS Counts the number of micro-ops Use cmask=1 and |
| 36 | delivered by loop stream detector invert to count |
| 37 | cycles |
| 38 | |
| 39 | raw encoding of 0x1A8 can be used: |
| 40 | |
| 41 | perf stat -e r1a8 -a sleep 1 |
| 42 | perf record -e r1a8 ... |
| 43 | |
| Arnaldo Carvalho de Melo | 1cf4a06 | 2010-05-07 14:07:05 -0300 | [diff] [blame^] | 44 | You should refer to the processor specific documentation for getting these |
| 45 | details. Some of them are referenced in the SEE ALSO section below. |
| 46 | |
| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 47 | OPTIONS |
| 48 | ------- |
| 49 | None |
| 50 | |
| 51 | SEE ALSO |
| 52 | -------- |
| 53 | linkperf:perf-stat[1], linkperf:perf-top[1], |
| Arnaldo Carvalho de Melo | 1cf4a06 | 2010-05-07 14:07:05 -0300 | [diff] [blame^] | 54 | linkperf:perf-record[1], |
| 55 | http://www.intel.com/Assets/PDF/manual/253669.pdf[Intel® 64 and IA-32 Architectures Software Developer's Manual Volume 3B: System Programming Guide], |
| 56 | http://support.amd.com/us/Processor_TechDocs/24593.pdf[AMD64 Architecture Programmer’s Manual Volume 2: System Programming] |