perf-list

Langue: en

Autres versions - même langue

Version: 10/19/2010 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

NAME

perf-list - List all symbolic event types

SYNOPSIS

 perf list
 

DESCRIPTION

This command displays the symbolic event types which can be selected in the various perf commands with the -e option.

RAW HARDWARE EVENT DESCRIPTOR

Even when an event is not available in a symbolic form within perf right now, it can be encoded in a per processor specific way.

For instance For x86 CPUs NNN represents the raw register encoding with the layout of IA32_PERFEVTSELx MSRs (see [Intel® 64 and IA-32 Architectures Software Developercqs Manual Volume 3B: System Programming Guide] Figure 30-1 Layout of IA32_PERFEVTSELx MSRs) or AMDcqs PerfEvtSeln (see [AMD64 Architecture Programmercqs Manual Volume 2: System Programming], Page 344, Figure 13-7 Performance Event-Select Register (PerfEvtSeln)).

Example:

If the Intel docs for a QM720 Core i7 describe an event as:

 Event  Umask  Event Mask
 Num.   Value  Mnemonic    Description                        Comment
 
 A8H      01H  LSD.UOPS    Counts the number of micro-ops     Use cmask=1 and
                           delivered by loop stream detector  invert to count
                                                              cycles
 

raw encoding of 0x1A8 can be used:

 perf stat -e r1a8 -a sleep 1
 perf record -e r1a8 ...
 

You should refer to the processor specific documentation for getting these details. Some of them are referenced in the SEE ALSO section below.

OPTIONS

None

SEE ALSO

perf-stat(1), perf-top(1), perf-record(1), m[blue]Intel® 64 and IA-32 Architectures Software Developercqs Manual Volume 3B: System Programming Guidem[][1], m[blue]AMD64 Architecture Programmercqs Manual Volume 2: System Programmingm[][2]

NOTES

1.
Intel® 64 and IA-32 Architectures Software Developercqs Manual Volume 3B: System Programming Guide
http://www.intel.com/Assets/PDF/manual/253669.pdf
2.
AMD64 Architecture Programmercqs Manual Volume 2: System Programming
http://support.amd.com/us/Processor_TechDocs/24593.pdf