[PATCH 4/4] ACPI/MRRM: ABI documentation for /sys/devices/system/memory/rangeX
From: Tony Luck
Date: Mon Feb 10 2025 - 16:13:13 EST
ABI providing users with a mapping between physical address ranges
and "region id" used by perf for uncore memory events and the
resctrl file system for per-region memory monitoring and control.
Signed-off-by: Tony Luck <tony.luck@xxxxxxxxx>
---
.../ABI/testing/sysfs-devices-memory | 32 +++++++++++++++++++
1 file changed, 32 insertions(+)
diff --git a/Documentation/ABI/testing/sysfs-devices-memory b/Documentation/ABI/testing/sysfs-devices-memory
index cec65827e602..fb01739e016e 100644
--- a/Documentation/ABI/testing/sysfs-devices-memory
+++ b/Documentation/ABI/testing/sysfs-devices-memory
@@ -118,3 +118,35 @@ Description:
(RO) indicates whether or not the kernel updates relevant kexec
segments on memory hot un/plug and/or on/offline events, avoiding the
need to reload kdump kernel.
+
+What: /sys/devices/system/memory/rangeX/base
+Date: January 2025
+Contact: Tony Luck <tony.luck@xxxxxxxxx>
+Description:
+ On systems with the ACPI MRRM table reports the
+ base system physical address of memory range X.
+
+What: /sys/devices/system/memory/rangeX/length
+Date: January 2025
+Contact: Tony Luck <tony.luck@xxxxxxxxx>
+Description:
+ On systems with the ACPI MRRM table reports the
+ size of rangeX system physical memory.
+
+What: /sys/devices/system/memory/rangeX/local_region_id
+Date: January 2025
+Contact: Tony Luck <tony.luck@xxxxxxxxx>
+Description:
+ On systems with the ACPI MRRM table reports the
+ the region id associated with memory access by
+ agents local to this range of addresses. Reports
+ 0xff when no region id has been assigned.
+
+What: /sys/devices/system/memory/rangeX/remote_region_id
+Date: January 2025
+Contact: Tony Luck <tony.luck@xxxxxxxxx>
+Description:
+ On systems with the ACPI MRRM table reports the
+ the region id associated with memory access by
+ agents non-local to this range of addresses. Reports
+ 0xff when no region id has been assigned.
--
2.48.1