fujitsu_uncore_pmu.rst

  1.. SPDX-License-Identifier: GPL-2.0-only
  2
  3================================================
  4Fujitsu Uncore Performance Monitoring Unit (PMU)
  5================================================
  6
  7This driver supports the Uncore MAC PMUs and the Uncore PCI PMUs found
  8in Fujitsu chips.
  9Each MAC PMU on these chips is exposed as a uncore perf PMU with device name
 10mac_iod<iod>_mac<mac>_ch<ch>.
 11And each PCI PMU on these chips is exposed as a uncore perf PMU with device name
 12pci_iod<iod>_pci<pci>.
 13
 14The driver provides a description of its available events and configuration
 15options in sysfs, see /sys/bus/event_sources/devices/mac_iod<iod>_mac<mac>_ch<ch>/
 16and /sys/bus/event_sources/devices/pci_iod<iod>_pci<pci>/.
 17This driver exports:
 18
 19- formats, used by perf user space and other tools to configure events
 20- events, used by perf user space and other tools to create events
 21  symbolically, e.g.::
 22
 23    perf stat -a -e mac_iod0_mac0_ch0/event=0x21/ ls
 24    perf stat -a -e pci_iod0_pci0/event=0x24/ ls
 25
 26- cpumask, used by perf user space and other tools to know on which CPUs
 27  to open the events
 28
 29This driver supports the following events for MAC:
 30
 31- cycles
 32  This event counts MAC cycles at MAC frequency.
 33- read-count
 34  This event counts the number of read requests to MAC.
 35- read-count-request
 36  This event counts the number of read requests including retry to MAC.
 37- read-count-return
 38  This event counts the number of responses to read requests to MAC.
 39- read-count-request-pftgt
 40  This event counts the number of read requests including retry with PFTGT
 41  flag.
 42- read-count-request-normal
 43  This event counts the number of read requests including retry without PFTGT
 44  flag.
 45- read-count-return-pftgt-hit
 46  This event counts the number of responses to read requests which hit the
 47  PFTGT buffer.
 48- read-count-return-pftgt-miss
 49  This event counts the number of responses to read requests which miss the
 50  PFTGT buffer.
 51- read-wait
 52  This event counts outstanding read requests issued by DDR memory controller
 53  per cycle.
 54- write-count
 55  This event counts the number of write requests to MAC (including zero write,
 56  full write, partial write, write cancel).
 57- write-count-write
 58  This event counts the number of full write requests to MAC (not including
 59  zero write).
 60- write-count-pwrite
 61  This event counts the number of partial write requests to MAC.
 62- memory-read-count
 63  This event counts the number of read requests from MAC to memory.
 64- memory-write-count
 65  This event counts the number of full write requests from MAC to memory.
 66- memory-pwrite-count
 67  This event counts the number of partial write requests from MAC to memory.
 68- ea-mac
 69  This event counts energy consumption of MAC.
 70- ea-memory
 71  This event counts energy consumption of memory.
 72- ea-memory-mac-write
 73  This event counts the number of write requests from MAC to memory.
 74- ea-ha
 75  This event counts energy consumption of HA.
 76
 77  'ea' is the abbreviation for 'Energy Analyzer'.
 78
 79Examples for use with perf::
 80
 81  perf stat -e mac_iod0_mac0_ch0/ea-mac/ ls
 82
 83And, this driver supports the following events for PCI:
 84
 85- pci-port0-cycles
 86  This event counts PCI cycles at PCI frequency in port0.
 87- pci-port0-read-count
 88  This event counts read transactions for data transfer in port0.
 89- pci-port0-read-count-bus
 90  This event counts read transactions for bus usage in port0.
 91- pci-port0-write-count
 92  This event counts write transactions for data transfer in port0.
 93- pci-port0-write-count-bus
 94  This event counts write transactions for bus usage in port0.
 95- pci-port1-cycles
 96  This event counts PCI cycles at PCI frequency in port1.
 97- pci-port1-read-count
 98  This event counts read transactions for data transfer in port1.
 99- pci-port1-read-count-bus
100  This event counts read transactions for bus usage in port1.
101- pci-port1-write-count
102  This event counts write transactions for data transfer in port1.
103- pci-port1-write-count-bus
104  This event counts write transactions for bus usage in port1.
105- ea-pci
106  This event counts energy consumption of PCI.
107
108  'ea' is the abbreviation for 'Energy Analyzer'.
109
110Examples for use with perf::
111
112  perf stat -e pci_iod0_pci0/ea-pci/ ls
113
114Given that these are uncore PMUs the driver does not support sampling, therefore
115"perf record" will not work. Per-task perf sessions are not supported.