From: Tony Luck <tony.luck@intel.com>
To: Robert Moore <robert.moore@intel.com>,
"Rafael J. Wysocki" <rafael.j.wysocki@intel.com>,
Len Brown <lenb@kernel.org>
Cc: linux-acpi@vger.kernel.org, acpica-devel@lists.linux.dev,
Thomas Gleixner <tglx@linutronix.de>,
Ingo Molnar <mingo@redhat.com>, Borislav Petkov <bp@alien8.de>,
Dave Hansen <dave.hansen@linux.intel.com>,
x86@kernel.org, "H. Peter Anvin" <hpa@zytor.com>,
David Hildenbrand <david@redhat.com>,
Oscar Salvador <osalvador@suse.de>,
Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Danilo Krummrich <dakr@kernel.org>,
Andrew Morton <akpm@linux-foundation.org>,
linux-kernel@vger.kernel.org, Tony Luck <tony.luck@intel.com>
Subject: [PATCH 4/4] ACPI/MRRM: ABI documentation for /sys/devices/system/memory/rangeX
Date: Mon, 10 Feb 2025 13:12:23 -0800 [thread overview]
Message-ID: <20250210211223.6139-5-tony.luck@intel.com> (raw)
In-Reply-To: <20250210211223.6139-1-tony.luck@intel.com>
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@intel.com>
---
.../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@intel.com>
+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@intel.com>
+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@intel.com>
+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@intel.com>
+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
prev parent reply other threads:[~2025-02-10 21:12 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-02-10 21:12 [PATCH 0/4] Add interfaces for ACPI MRRM table Tony Luck
2025-02-10 21:12 ` [PATCH 1/4] ACPICA: Define MRRM ACPI table Tony Luck
2025-02-11 12:16 ` Rafael J. Wysocki
2025-02-10 21:12 ` [PATCH 2/4] ACPI/MRRM: Create /sys/devices/system/memory/rangeX ABI Tony Luck
2025-02-11 0:21 ` Luck, Tony
2025-02-11 13:08 ` David Hildenbrand
2025-02-10 21:12 ` [PATCH 3/4] ACPI/MRRM: Add "node" symlink to /sys/devices/system/memory/rangeX Tony Luck
2025-02-11 6:51 ` Greg Kroah-Hartman
2025-02-11 13:27 ` David Hildenbrand
2025-02-11 18:05 ` Luck, Tony
2025-02-13 13:30 ` David Hildenbrand
2025-02-13 19:05 ` Luck, Tony
2025-02-11 17:02 ` Luck, Tony
2025-02-12 7:48 ` Greg Kroah-Hartman
2025-02-10 21:12 ` Tony Luck [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250210211223.6139-5-tony.luck@intel.com \
--to=tony.luck@intel.com \
--cc=acpica-devel@lists.linux.dev \
--cc=akpm@linux-foundation.org \
--cc=bp@alien8.de \
--cc=dakr@kernel.org \
--cc=dave.hansen@linux.intel.com \
--cc=david@redhat.com \
--cc=gregkh@linuxfoundation.org \
--cc=hpa@zytor.com \
--cc=lenb@kernel.org \
--cc=linux-acpi@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mingo@redhat.com \
--cc=osalvador@suse.de \
--cc=rafael.j.wysocki@intel.com \
--cc=robert.moore@intel.com \
--cc=tglx@linutronix.de \
--cc=x86@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox