xref: /linux/Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst (revision feafee284579d29537a5a56ba8f23894f0463f3d)
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- formats, used by perf user space and other tools to configure events
19- events, used by perf user space and other tools to create events
20  symbolically, e.g.:
21    perf stat -a -e mac_iod0_mac0_ch0/event=0x21/ ls
22    perf stat -a -e pci_iod0_pci0/event=0x24/ ls
23- cpumask, used by perf user space and other tools to know on which CPUs
24  to open the events
25
26This driver supports the following events for MAC:
27- cycles
28  This event counts MAC cycles at MAC frequency.
29- read-count
30  This event counts the number of read requests to MAC.
31- read-count-request
32  This event counts the number of read requests including retry to MAC.
33- read-count-return
34  This event counts the number of responses to read requests to MAC.
35- read-count-request-pftgt
36  This event counts the number of read requests including retry with PFTGT
37  flag.
38- read-count-request-normal
39  This event counts the number of read requests including retry without PFTGT
40  flag.
41- read-count-return-pftgt-hit
42  This event counts the number of responses to read requests which hit the
43  PFTGT buffer.
44- read-count-return-pftgt-miss
45  This event counts the number of responses to read requests which miss the
46  PFTGT buffer.
47- read-wait
48  This event counts outstanding read requests issued by DDR memory controller
49  per cycle.
50- write-count
51  This event counts the number of write requests to MAC (including zero write,
52  full write, partial write, write cancel).
53- write-count-write
54  This event counts the number of full write requests to MAC (not including
55  zero write).
56- write-count-pwrite
57  This event counts the number of partial write requests to MAC.
58- memory-read-count
59  This event counts the number of read requests from MAC to memory.
60- memory-write-count
61  This event counts the number of full write requests from MAC to memory.
62- memory-pwrite-count
63  This event counts the number of partial write requests from MAC to memory.
64- ea-mac
65  This event counts energy consumption of MAC.
66- ea-memory
67  This event counts energy consumption of memory.
68- ea-memory-mac-write
69  This event counts the number of write requests from MAC to memory.
70- ea-ha
71  This event counts energy consumption of HA.
72
73  'ea' is the abbreviation for 'Energy Analyzer'.
74
75Examples for use with perf::
76
77  perf stat -e mac_iod0_mac0_ch0/ea-mac/ ls
78
79And, this driver supports the following events for PCI:
80- pci-port0-cycles
81  This event counts PCI cycles at PCI frequency in port0.
82- pci-port0-read-count
83  This event counts read transactions for data transfer in port0.
84- pci-port0-read-count-bus
85  This event counts read transactions for bus usage in port0.
86- pci-port0-write-count
87  This event counts write transactions for data transfer in port0.
88- pci-port0-write-count-bus
89  This event counts write transactions for bus usage in port0.
90- pci-port1-cycles
91  This event counts PCI cycles at PCI frequency in port1.
92- pci-port1-read-count
93  This event counts read transactions for data transfer in port1.
94- pci-port1-read-count-bus
95  This event counts read transactions for bus usage in port1.
96- pci-port1-write-count
97  This event counts write transactions for data transfer in port1.
98- pci-port1-write-count-bus
99  This event counts write transactions for bus usage in port1.
100- ea-pci
101  This event counts energy consumption of PCI.
102
103  'ea' is the abbreviation for 'Energy Analyzer'.
104
105Examples for use with perf::
106
107  perf stat -e pci_iod0_pci0/ea-pci/ ls
108
109Given that these are uncore PMUs the driver does not support sampling, therefore
110"perf record" will not work. Per-task perf sessions are not supported.
111