perf-list.txt 1.9 KB

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