Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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.