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. 116