From: Babu Moger <babu.moger@amd.com>
To: <corbet@lwn.net>, <tony.luck@intel.com>,
<reinette.chatre@intel.com>, <Dave.Martin@arm.com>,
<james.morse@arm.com>, <babu.moger@amd.com>, <tglx@kernel.org>,
<mingo@redhat.com>, <bp@alien8.de>, <dave.hansen@linux.intel.com>
Cc: <x86@kernel.org>, <hpa@zytor.com>, <peterz@infradead.org>,
<juri.lelli@redhat.com>, <vincent.guittot@linaro.org>,
<dietmar.eggemann@arm.com>, <rostedt@goodmis.org>,
<bsegall@google.com>, <mgorman@suse.de>, <vschneid@redhat.com>,
<akpm@linux-foundation.org>, <pawan.kumar.gupta@linux.intel.com>,
<pmladek@suse.com>, <feng.tang@linux.alibaba.com>,
<kees@kernel.org>, <arnd@arndb.de>, <fvdl@google.com>,
<lirongqing@baidu.com>, <bhelgaas@google.com>,
<seanjc@google.com>, <xin@zytor.com>, <manali.shukla@amd.com>,
<dapeng1.mi@linux.intel.com>, <chang.seok.bae@intel.com>,
<mario.limonciello@amd.com>, <naveen@kernel.org>,
<elena.reshetova@intel.com>, <thomas.lendacky@amd.com>,
<linux-doc@vger.kernel.org>, <linux-kernel@vger.kernel.org>,
<kvm@vger.kernel.org>, <peternewman@google.com>,
<eranian@google.com>, <gautham.shenoy@amd.com>
Subject: [RFC PATCH 04/19] fs/resctrl: Add the documentation for Global Memory Bandwidth Allocation
Date: Wed, 21 Jan 2026 15:12:42 -0600 [thread overview]
Message-ID: <d58f70592a4ce89e744e7378e49d5a36be3fd05e.1769029977.git.babu.moger@amd.com> (raw)
In-Reply-To: <cover.1769029977.git.babu.moger@amd.com>
Add the documentation and example to setup Global Memory Bandwidth
Allocation (GMBA) in resctrl filesystem.
Signed-off-by: Babu Moger <babu.moger@amd.com>
---
Documentation/filesystems/resctrl.rst | 43 +++++++++++++++++++++++++--
1 file changed, 41 insertions(+), 2 deletions(-)
diff --git a/Documentation/filesystems/resctrl.rst b/Documentation/filesystems/resctrl.rst
index 94187dd3c244..6ff6162719e8 100644
--- a/Documentation/filesystems/resctrl.rst
+++ b/Documentation/filesystems/resctrl.rst
@@ -28,6 +28,7 @@ SMBA (Slow Memory Bandwidth Allocation) ""
BMEC (Bandwidth Monitoring Event Configuration) ""
ABMC (Assignable Bandwidth Monitoring Counters) ""
SDCIAE (Smart Data Cache Injection Allocation Enforcement) ""
+GMBA (Global Memory Bandwidth Allocation) ""
=============================================================== ================================
Historically, new features were made visible by default in /proc/cpuinfo. This
@@ -960,6 +961,21 @@ Memory bandwidth domain is L3 cache.
MB:<cache_id0>=bw_MiBps0;<cache_id1>=bw_MiBps1;...
+Global Memory bandwidth Allocation
+-----------------------------------
+
+AMD hardware supports Global Memory Bandwidth Allocation (GMBA) provides
+a mechanism for software to specify bandwidth limits for groups of threads
+that span across multiple QoS domains. This collection of QOS domains is
+referred to as GMBA control domain. The GMBA control domain is created by
+setting the same GMBA limits in one or more QoS domains. Setting the default
+max_bandwidth excludes the QoS domain from being part of GMBA control domain.
+
+Global Memory b/w domain is L3 cache.
+::
+
+ GMB:<cache_id0>=bandwidth;<cache_id1>=bandwidth;...
+
Slow Memory Bandwidth Allocation (SMBA)
---------------------------------------
AMD hardware supports Slow Memory Bandwidth Allocation (SMBA).
@@ -997,8 +1013,8 @@ which you wish to change. E.g.
Reading/writing the schemata file (on AMD systems)
--------------------------------------------------
Reading the schemata file will show the current bandwidth limit on all
-domains. The allocated resources are in multiples of one eighth GB/s.
-When writing to the file, you need to specify what cache id you wish to
+domains. The allocated resources are in multiples of 1/8 GB/s. When
+writing to the file, you need to specify what cache id you wish to
configure the bandwidth limit.
For example, to allocate 2GB/s limit on the first cache id:
@@ -1014,6 +1030,29 @@ For example, to allocate 2GB/s limit on the first cache id:
MB:0=2048;1= 16;2=2048;3=2048
L3:0=ffff;1=ffff;2=ffff;3=ffff
+Reading/writing the schemata file (on AMD systems) with GMBA feature
+--------------------------------------------------------------------
+Reading the schemata file will show the current bandwidth limit on all
+domains. The allocated resources are in multiples of 1 GB/s. The GMBA
+control domain is created by setting the same GMBA limits in one or more
+QoS domains.
+
+For example, to configure a GMBA domain consisting of domains 0 and 2
+with an 8 GB/s limit:
+
+::
+
+ # cat schemata
+ GMB:0=2048;1=2048;2=2048;3=2048
+ MB:0=4096;1=4096;2=4096;3=4096
+ L3:0=ffff;1=ffff;2=ffff;3=ffff
+
+ # echo "GMB:0=8;2=8" > schemata
+ # cat schemata
+ GMB:0= 8;1=2048;2= 8;3=2048
+ MB:0=4096;1=4096;2=4096;3=4096
+ L3:0=ffff;1=ffff;2=ffff;3=ffff
+
Reading/writing the schemata file (on AMD systems) with SMBA feature
--------------------------------------------------------------------
Reading and writing the schemata file is the same as without SMBA in
--
2.34.1
next prev parent reply other threads:[~2026-01-21 21:13 UTC|newest]
Thread overview: 114+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-01-21 21:12 [RFC PATCH 00/19] x86,fs/resctrl: Support for Global Bandwidth Enforcement and Priviledge Level Zero Association Babu Moger
2026-01-21 21:12 ` [RFC PATCH 01/19] x86,fs/resctrl: Add support for Global Bandwidth Enforcement (GLBE) Babu Moger
2026-02-09 18:44 ` Reinette Chatre
2026-02-11 1:07 ` Moger, Babu
2026-02-11 16:54 ` Reinette Chatre
2026-02-11 21:18 ` Babu Moger
2026-02-12 3:51 ` Reinette Chatre
2026-02-12 19:09 ` Babu Moger
2026-02-13 0:05 ` Reinette Chatre
2026-02-13 1:51 ` Moger, Babu
2026-02-13 16:17 ` Reinette Chatre
2026-02-13 23:14 ` Moger, Babu
2026-02-14 0:01 ` Reinette Chatre
2026-02-16 16:05 ` Babu Moger
2026-02-20 10:07 ` Ben Horgan
2026-02-20 18:39 ` Reinette Chatre
2026-02-23 9:29 ` Ben Horgan
2026-02-21 0:12 ` Moger, Babu
2026-02-23 13:21 ` Fenghua Yu
2026-02-23 17:38 ` Reinette Chatre
2026-02-23 13:21 ` Fenghua Yu
2026-01-21 21:12 ` [RFC PATCH 02/19] x86,fs/resctrl: Add the resource for Global Memory Bandwidth Allocation Babu Moger
2026-01-21 21:12 ` [RFC PATCH 03/19] fs/resctrl: Add new interface max_bandwidth Babu Moger
2026-02-06 23:58 ` Reinette Chatre
2026-02-09 23:52 ` Moger, Babu
2026-01-21 21:12 ` Babu Moger [this message]
2026-02-03 0:00 ` [RFC PATCH 04/19] fs/resctrl: Add the documentation for Global Memory Bandwidth Allocation Luck, Tony
2026-02-03 16:38 ` Babu Moger
2026-02-09 16:32 ` Reinette Chatre
2026-02-10 19:44 ` Babu Moger
2026-01-21 21:12 ` [RFC PATCH 05/19] x86,fs/resctrl: Add support for Global Slow Memory Bandwidth Allocation (GSMBA) Babu Moger
2026-01-21 21:12 ` [RFC PATCH 06/19] x86,fs/resctrl: Add the resource for Global Slow Memory Bandwidth Enforcement(GLSBE) Babu Moger
2026-01-21 21:12 ` [RFC PATCH 07/19] fs/resctrl: Add the documentation for Global Slow Memory Bandwidth Allocation Babu Moger
2026-01-21 21:12 ` [RFC PATCH 08/19] x86/resctrl: Support Privilege-Level Zero Association (PLZA) Babu Moger
2026-01-21 21:12 ` [RFC PATCH 09/19] x86/resctrl: Add plza_capable in rdt_resource data structure Babu Moger
2026-02-11 15:19 ` Ben Horgan
2026-02-11 16:54 ` Reinette Chatre
2026-02-11 17:48 ` Ben Horgan
2026-02-13 15:50 ` Moger, Babu
2026-01-21 21:12 ` [RFC PATCH 10/19] fs/resctrl: Expose plza_capable via control info file Babu Moger
2026-01-21 21:12 ` [RFC PATCH 11/19] resctrl: Introduce PLZA static key enable/disable helpers Babu Moger
2026-01-21 21:12 ` [RFC PATCH 12/19] x86/resctrl: Add data structures and definitions for PLZA configuration Babu Moger
2026-01-21 21:12 ` [RFC PATCH 13/19] x86/resctrl: Add PLZA state tracking and context switch handling Babu Moger
2026-01-27 22:30 ` Luck, Tony
2026-01-28 16:01 ` Moger, Babu
2026-01-28 17:12 ` Luck, Tony
2026-01-28 17:41 ` Moger, Babu
2026-01-28 17:44 ` Moger, Babu
2026-01-28 19:17 ` Luck, Tony
2026-02-10 16:17 ` Reinette Chatre
2026-02-10 18:04 ` Reinette Chatre
2026-02-11 16:40 ` Ben Horgan
2026-02-11 19:46 ` Luck, Tony
2026-02-11 22:22 ` Reinette Chatre
2026-02-12 13:55 ` Ben Horgan
2026-02-12 18:37 ` Reinette Chatre
2026-02-16 15:18 ` Ben Horgan
2026-02-17 18:51 ` Reinette Chatre
2026-02-17 21:44 ` Luck, Tony
2026-02-17 22:37 ` Reinette Chatre
2026-02-17 22:52 ` Luck, Tony
2026-02-17 23:55 ` Reinette Chatre
2026-02-18 16:44 ` Luck, Tony
2026-02-19 17:03 ` Luck, Tony
2026-02-19 17:45 ` Ben Horgan
2026-02-20 8:21 ` Drew Fustini
2026-02-19 17:33 ` Ben Horgan
2026-02-20 2:53 ` Reinette Chatre
2026-02-20 22:44 ` Moger, Babu
2026-02-23 17:12 ` Reinette Chatre
2026-02-23 22:35 ` Moger, Babu
2026-02-23 23:13 ` Reinette Chatre
2026-02-24 19:37 ` Babu Moger
2026-02-23 10:08 ` Ben Horgan
2026-02-23 16:38 ` Reinette Chatre
2026-02-24 9:36 ` Ben Horgan
2026-02-24 16:13 ` Reinette Chatre
2026-02-19 11:06 ` Ben Horgan
2026-02-19 18:12 ` Luck, Tony
2026-02-19 18:36 ` Reinette Chatre
2026-02-19 10:21 ` Ben Horgan
2026-02-19 18:14 ` Reinette Chatre
2026-02-23 9:48 ` Ben Horgan
2026-02-13 16:37 ` Moger, Babu
2026-02-13 17:02 ` Luck, Tony
2026-02-16 19:24 ` Babu Moger
2026-02-14 0:10 ` Reinette Chatre
2026-02-16 15:41 ` Ben Horgan
2026-02-16 22:52 ` Moger, Babu
2026-02-17 15:56 ` Ben Horgan
2026-02-17 16:38 ` Babu Moger
2026-02-18 9:54 ` Ben Horgan
2026-02-18 6:22 ` Stephane Eranian
2026-02-18 9:35 ` Ben Horgan
2026-02-19 10:27 ` Ben Horgan
2026-02-16 22:36 ` Moger, Babu
2026-02-12 10:00 ` Ben Horgan
2026-01-21 21:12 ` [RFC PATCH 14/19] x86,fs/resctrl: Add the functionality to configure PLZA Babu Moger
2026-01-29 19:13 ` Luck, Tony
2026-01-29 19:53 ` Babu Moger
2026-01-21 21:12 ` [RFC PATCH 15/19] fs/resctrl: Introduce PLZA attribute in rdtgroup interface Babu Moger
2026-01-21 21:12 ` [RFC PATCH 16/19] fs/resctrl: Implement rdtgroup_plza_write() to configure PLZA in a group Babu Moger
2026-01-28 22:03 ` Luck, Tony
2026-01-29 18:54 ` Luck, Tony
2026-01-29 19:31 ` Babu Moger
2026-01-29 19:42 ` Babu Moger
2026-02-10 0:05 ` Reinette Chatre
2026-02-11 23:10 ` Moger, Babu
2026-01-21 21:12 ` [RFC PATCH 17/19] fs/resctrl: Update PLZA configuration when cpu_mask changes Babu Moger
2026-01-21 21:12 ` [RFC PATCH 18/19] x86/resctrl: Refactor show_rdt_tasks() to support PLZA task matching Babu Moger
2026-01-21 21:12 ` [RFC PATCH 19/19] fs/resctrl: Add per-task PLZA enable support via rdtgroup Babu Moger
2026-02-03 19:58 ` [RFC PATCH 00/19] x86,fs/resctrl: Support for Global Bandwidth Enforcement and Priviledge Level Zero Association Luck, Tony
2026-02-10 0:27 ` Reinette Chatre
2026-02-11 0:40 ` Drew Fustini
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=d58f70592a4ce89e744e7378e49d5a36be3fd05e.1769029977.git.babu.moger@amd.com \
--to=babu.moger@amd.com \
--cc=Dave.Martin@arm.com \
--cc=akpm@linux-foundation.org \
--cc=arnd@arndb.de \
--cc=bhelgaas@google.com \
--cc=bp@alien8.de \
--cc=bsegall@google.com \
--cc=chang.seok.bae@intel.com \
--cc=corbet@lwn.net \
--cc=dapeng1.mi@linux.intel.com \
--cc=dave.hansen@linux.intel.com \
--cc=dietmar.eggemann@arm.com \
--cc=elena.reshetova@intel.com \
--cc=eranian@google.com \
--cc=feng.tang@linux.alibaba.com \
--cc=fvdl@google.com \
--cc=gautham.shenoy@amd.com \
--cc=hpa@zytor.com \
--cc=james.morse@arm.com \
--cc=juri.lelli@redhat.com \
--cc=kees@kernel.org \
--cc=kvm@vger.kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=lirongqing@baidu.com \
--cc=manali.shukla@amd.com \
--cc=mario.limonciello@amd.com \
--cc=mgorman@suse.de \
--cc=mingo@redhat.com \
--cc=naveen@kernel.org \
--cc=pawan.kumar.gupta@linux.intel.com \
--cc=peternewman@google.com \
--cc=peterz@infradead.org \
--cc=pmladek@suse.com \
--cc=reinette.chatre@intel.com \
--cc=rostedt@goodmis.org \
--cc=seanjc@google.com \
--cc=tglx@kernel.org \
--cc=thomas.lendacky@amd.com \
--cc=tony.luck@intel.com \
--cc=vincent.guittot@linaro.org \
--cc=vschneid@redhat.com \
--cc=x86@kernel.org \
--cc=xin@zytor.com \
/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
all inboxes | Powered by JetHome®