Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst

Source file repositories/reference/linux-study-clean/Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst

File Facts

System
Linux kernel
Corpus path
Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst
Extension
.rst
Size
4291 bytes
Lines
116
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. SPDX-License-Identifier: GPL-2.0-only

================================================
Fujitsu Uncore Performance Monitoring Unit (PMU)
================================================

This driver supports the Uncore MAC PMUs and the Uncore PCI PMUs found
in Fujitsu chips.
Each MAC PMU on these chips is exposed as a uncore perf PMU with device name
mac_iod<iod>_mac<mac>_ch<ch>.
And each PCI PMU on these chips is exposed as a uncore perf PMU with device name
pci_iod<iod>_pci<pci>.

The driver provides a description of its available events and configuration
options in sysfs, see /sys/bus/event_sources/devices/mac_iod<iod>_mac<mac>_ch<ch>/
and /sys/bus/event_sources/devices/pci_iod<iod>_pci<pci>/.
This driver exports:

- formats, used by perf user space and other tools to configure events
- events, used by perf user space and other tools to create events
  symbolically, e.g.::

    perf stat -a -e mac_iod0_mac0_ch0/event=0x21/ ls
    perf stat -a -e pci_iod0_pci0/event=0x24/ ls

- cpumask, used by perf user space and other tools to know on which CPUs
  to open the events

This driver supports the following events for MAC:

- cycles
  This event counts MAC cycles at MAC frequency.
- read-count
  This event counts the number of read requests to MAC.
- read-count-request
  This event counts the number of read requests including retry to MAC.
- read-count-return
  This event counts the number of responses to read requests to MAC.
- read-count-request-pftgt
  This event counts the number of read requests including retry with PFTGT
  flag.
- read-count-request-normal
  This event counts the number of read requests including retry without PFTGT
  flag.
- read-count-return-pftgt-hit
  This event counts the number of responses to read requests which hit the
  PFTGT buffer.
- read-count-return-pftgt-miss
  This event counts the number of responses to read requests which miss the
  PFTGT buffer.
- read-wait
  This event counts outstanding read requests issued by DDR memory controller
  per cycle.
- write-count
  This event counts the number of write requests to MAC (including zero write,
  full write, partial write, write cancel).
- write-count-write
  This event counts the number of full write requests to MAC (not including
  zero write).
- write-count-pwrite
  This event counts the number of partial write requests to MAC.
- memory-read-count
  This event counts the number of read requests from MAC to memory.
- memory-write-count
  This event counts the number of full write requests from MAC to memory.
- memory-pwrite-count
  This event counts the number of partial write requests from MAC to memory.
- ea-mac
  This event counts energy consumption of MAC.
- ea-memory

Annotation

Implementation Notes