-
Notifications
You must be signed in to change notification settings - Fork 192
MMIO interface options
Roman Storozhenko edited this page May 20, 2026
·
2 revisions
This document describes usage of RDT Architecture Specification MMIO features in the RDT Utility (PQoS) software.
- https://www.intel.com/content/www/us/en/architecture-and-technology/resource-director-technology.html
- Intel RDT architecture specification
This command provides total memory regions, base address, and range.
$ pqos --iface=mmio --print-mem-regions
Total Memory Regions: 2
Region ID Type: Static
Base Address : 0x0
Length : 0xc0000000
Local Region ID : 0x0
Remote Region ID : Not Valid
Base Address : 0x100000000
Length : 0xff40000000
Local Region ID : 0x0
Remote Region ID : Not Valid
Base Address : 0x18000000000
Length : 0x20000000000
Local Region ID : 0x1
Remote Region ID : Not Valid
Base Address : 0x38000000000
Length : 0x20000000000
Local Region ID : 0x1
Remote Region ID : Not Valid
Base Address : 0x58000000000
Length : 0x8000000000
Local Region ID : 0x1
Remote Region ID : Not ValidThis command provides available CPU agents and device agents, and associated cores.
$ pqos --iface=mmio --print-topology
CLOS: 16
CPU Agents: 4
Device Agents: 2
Domain ID 0
Type: CPU
CACD Info:
Domain ID: 0
Enumeration IDs: 0x0 0x2 0x8 0xa 0x10 0x12 0x18 0x1a 0x20 0x22 0x28 0x2a 0x30 0x32 0x38 0x3a 0x40 0x42 0x48 0x4a 0x50 0x52 0x58 0x5a 0x60 0x62 0x68 0x6a 0x70 0x72 0x78 0x7a 0x80 0x82 0x98 0x9a 0
xa8 0xaa 0xb0 0xb2 0xb8 0xba 0xc0 0xc2 0xc8 0xca 0xd0 0xd2 0xe0 0xe2 0xe8 0xea 0xf0 0xf2 0xf8 0xfa
CMRC Info:
Unavailable Bit Support: No
Indexing Function Version: 1
CMT Register Block Base Address: 0x1ffff7fb1000
CMT Register Block Size: 0x4
CMT Register Clump Size: 0x8
CMT Register Clump Stride: 0x200
CMT Counter Upscaling Factor: 0x40000
MMRC Info:
Unavailable Bit Support: No
Overflow Bit Support: No
Indexing Function Version: 1
MBM Register Block Base Address: 0x1ffff7fc8000
MBM Register Block Size: 0x10
MBM Counter Width: 0x20
MBM Counter Upscaling Factor: 0x40000
MBM Correction Factor List Length: 0
MARC Info:
MBA Optimal Control Window: Yes
MBA Minimum Control Window: Yes
MBA Maximum Control Window: Yes
Indexing Function Version: 1
MBA Optimal BW Register Block Base Address: 0x1ffff7fc1000
MBA Minimum BW Register Block Base Address: 0x1ffff7fc3000
MBA Maximum BW Register Block Base Address: 0x1ffff7fc2000
MBA Register Block Size: 0x1
MBA BW Control Window Range: 255
Domain ID 1
Type: CPU
CACD Info:
Domanin ID: 1
Enumeration IDs: 0x100 0x102 0x108 0x10a 0x110 0x112 0x118 0x11a 0x120 0x122 0x128 0x12a 0x130 0x132 0x138 0x13a 0x140 0x142 0x148 0x14a 0x150 0x152 0x158 0x15a 0x160 0x162 0x170 0x172 0x178 0x1
7a 0x188 0x18a 0x1a0 0x1a2 0x1a8 0x1aa 0x1b0 0x1b2 0x1b8 0x1ba 0x1c0 0x1c2 0x1c8 0x1ca 0x1d0 0x1d2 0x1d8 0x1da 0x1e0 0x1e2 0x1e8 0x1ea 0x1f0 0x1f2 0x1f8 0x1fa
CMRC Info:
Unavailable Bit Support: No
Indexing Function Version: 1
CMT Register Block Base Address: 0x1ffff7eb1000
CMT Register Block Size: 0x4
CMT Register Clump Size: 0x8
CMT Register Clump Stride: 0x200
CMT Counter Upscaling Factor: 0x40000
MMRC Info:
Unavailable Bit Support: No
Overflow Bit Support: No
Indexing Function Version: 1
MBM Register Block Base Address: 0x1ffff7ec8000
MBM Register Block Size: 0x10
MBM Counter Width: 0x20
MBM Counter Upscaling Factor: 0x40000
MBM Correction Factor List Length: 0
MARC Info:
MBA Optimal Control Window: Yes
MBA Minimum Control Window: Yes
MBA Maximum Control Window: Yes
Indexing Function Version: 1
MBA Optimal BW Register Block Base Address: 0x1ffff7ec1000
MBA Minimum BW Register Block Base Address: 0x1ffff7ec3000
MBA Maximum BW Register Block Base Address: 0x1ffff7ec2000
MBA Register Block Size: 0x1
MBA BW Control Window Range: 255
........................................................................................................................................................................................................................
Domain ID 16
Type: Device
DACD Info:
Domain ID: 16
Number of DASEs: 30
DASE 0:
Type: 1
Segment Number: 0
Start Bus Number: 0
Path: 0x00 0x00
DASE 1:
Type: 1
Segment Number: 0
Start Bus Number: 0
Path: 0x00 0x04
...........................................
DASE 29:
Type: 1
Segment Number: 0
Start Bus Number: b0
Path: 0x02 0x00 0x00 0x01
CMRD Info:
Unavailable Bit Support: No
Indexing Function Version: 1
Register Base Address: 0x1ffff6b8b000
Register Block Size: 0x10
CMT Register Clump Size: 0x500
CMT Register Clump Size: 0x8
CMT Counter Upscaling Factor: 0x400
IBRD Info:
Unavailable Bit Support: No
Overflow Bit Support: No
Indexing Function Version: 1
Register Base Address: 0x1ffff6b8b000
Register Block Size: 0x10
Total I/O BW Register Offset: 0x300
I/O Miss BW Register Offset: 0x400
Total I/O BW Register Clump Size: 0x8
I/O Miss Register Clump Size: 0x8
I/O BW Counter Width: 0x28
I/O BW Counter Upscaling Factor: 0x400
I/O BW Counter Correction Factor List Length: 0
CARD Info:
Contention Bitmask Valid: No
Non-Contiguous Bitmasks Supported: Yes
Zero-length Bitmask: No
Contention Bitmask: 0x0
Indexing Function Version: 1
Register Base Address: 0x1ffff6b8b000
Register Block Size: 0x10
CAT Register Offset: 0x200
CAT Register Block Size: 0x10
.......................................................................................................................................................................................................................
Domain ID 17
Type: Device
DACD Info:
Domain ID: 17
Number of DASEs: 13
DASE 0:
Type: 1
Segment Number: 1
Start Bus Number: 0
Path: 0x00 0x00
.......................................................................................................................................................................................................................Example 1:
$ pqos --iface=mmio -m all:0-5
TIME 2026-03-16 10:20:04
CORE IPC MISSES LLC[KB] MBT-r0[MB/s] MBT-r1[MB/s] MBT-r2[MB/s] MBT-r3[MB/s]
0 0.31 6k 0.0 0.0 0.0 0.0 0.0
1 0.65 0k 0.0 0.0 0.0 0.0 0.0
2 0.77 0k 0.0 0.0 0.0 0.0 0.0
3 0.86 0k 0.0 0.0 0.0 0.0 0.0
4 0.28 1k 0.0 0.0 0.0 0.0 0.0
5 0.53 0k 0.0 0.0 0.0 0.0 0.0Example 1: Monitor region 1
$ pqos --iface=mmio --mon-mem-region=1 -m all:0-5
TIME 2026-03-16 10:33:06
CORE IPC MISSES LLC[KB] MBT-r1[MB/s]
0 0.25 8k 0.0 0.0
1 0.45 0k 0.0 0.0
2 0.20 2k 0.0 0.0
3 0.40 0k 0.0 0.0
4 0.47 0k 0.0 0.0
5 0.41 0k 0.0 0.0pqos --iface=mmio --mem-region=<region numbers>Example 1:
$ pqos --iface=mmio --mon-mem-region=2,1 -m all:0-5
TIME 2026-03-16 11:34:02
CORE IPC MISSES LLC[KB] MBT-r2[MB/s] MBT-r1[MB/s]
0 0.41 6k 0.0 0.0 0.0
1 0.42 0k 0.0 0.0 0.0
2 0.43 0k 0.0 0.0 0.0
3 0.45 0k 0.0 0.0 0.0
4 0.17 1k 0.0 0.0 0.0
5 0.13 0k 0.0 0.0 0.0Note: Q values range is 0x0 - 0x1FF. If min, max, and opt options are not provided, then Q values are applied to all bandwidth control types.
Example 1:
The CLOS 1 and CLOS 2 in domain 0 are set to 0x50 and 0x70 respectively for memory region 0.
$ pqos --iface=mmio --alloc-domain-id=0 --alloc-mem-region=0 -e "mba:1=0x50;mba:2=0x70;"
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Domain ID 0 MBA COS1 Memory Region 0 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 0 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 0 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS2 Memory Region 0 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 0 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 0 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Allocation configuration altered.Example 2:
The CLOS 1 and CLOS 2 in domains 0,1,2,3 are set to 0x50 and 0x70 respectively for memory region 3.
$ pqos --iface=mmio --alloc-domain-id=0,1,2,3 --alloc-mem-region=3 -e "mba:1=0x50;mba:2=0x70;"
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Domain ID 0 MBA COS1 Memory Region 3 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 3 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 3 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 3 Optimal Bandwidth=> 0x50 requested, 0xff applied
Domain ID 1 MBA COS1 Memory Region 3 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 1 MBA COS1 Memory Region 3 Maximum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 2 MBA COS1 Memory Region 3 Optimal Bandwidth=> 0x50 requested, 0xff applied
Domain ID 2 MBA COS1 Memory Region 3 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 2 MBA COS1 Memory Region 3 Maximum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 3 MBA COS1 Memory Region 3 Optimal Bandwidth=> 0x50 requested, 0xff applied
Domain ID 3 MBA COS1 Memory Region 3 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 3 MBA COS1 Memory Region 3 Maximum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 0 MBA COS2 Memory Region 3 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 3 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 3 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 3 Optimal Bandwidth=> 0x70 requested, 0xff applied
Domain ID 1 MBA COS2 Memory Region 3 Minimum Bandwidth=> 0x70 requested, 0xff applied
Domain ID 1 MBA COS2 Memory Region 3 Maximum Bandwidth=> 0x70 requested, 0xff applied
Domain ID 2 MBA COS2 Memory Region 3 Optimal Bandwidth=> 0x70 requested, 0xff applied
Domain ID 2 MBA COS2 Memory Region 3 Minimum Bandwidth=> 0x70 requested, 0xff applied
Domain ID 2 MBA COS2 Memory Region 3 Maximum Bandwidth=> 0x70 requested, 0xff applied
Domain ID 3 MBA COS2 Memory Region 3 Optimal Bandwidth=> 0x70 requested, 0xff applied
Domain ID 3 MBA COS2 Memory Region 3 Minimum Bandwidth=> 0x70 requested, 0xff applied
Domain ID 3 MBA COS2 Memory Region 3 Maximum Bandwidth=> 0xff applied
Allocation configuration altered.Example 3:
The CLOS 1 and CLOS 2 in domains 0,1,2,3 are set to 0x50 and 0x70 respectively for memory region 1. Only the minimum bandwidth control type is applied in this example.
--alloc-max-bw and --alloc-opt-bw are also possible. See the next example.
$ pqos --iface=mmio --alloc-domain-id=0-3 --alloc-mem-region=1 --alloc-min-bw -e "mba:1=0x50;mba:2=0x70;"
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Domain ID 0 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 2 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 3 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 0 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x70 requested, 0xff applied
Domain ID 2 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x70 requested, 0xff applied
Domain ID 3 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x70 requested, 0xff applied
Allocation configuration altered.Example 4:
The CLOS1 MBA is set as Q value 80 in domains 0 and 2.
The CLOS2 MBA is set as Q value 64 in domains 0 and 2.
The CLOS3 MBA is set as Q value 85 in domains 0 and 2.
This is applicable to all bandwidth control types (min, max, and opt) in memory region 1.
$ pqos --iface=mmio --alloc-domain-id=0-2 --alloc-mem-region=1 --alloc-min-bw --alloc-max-bw --alloc-opt-bw -e "mba:1=80;mba:2=64;mba:3=85"
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Domain ID 0 MBA COS1 Memory Region 1 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 1 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 1 Optimal Bandwidth=> 0x50 requested, 0xff applied
Domain ID 1 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 1 MBA COS1 Memory Region 1 Maximum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 2 MBA COS1 Memory Region 1 Optimal Bandwidth=> 0x50 requested, 0xff applied
Domain ID 2 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 2 MBA COS1 Memory Region 1 Maximum Bandwidth=> 0x50 requested, 0xff applied
Domain ID 0 MBA COS2 Memory Region 1 Optimal Bandwidth=> 0x40 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x40 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 1 Maximum Bandwidth=> 0x40 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 1 Optimal Bandwidth=> 0x40 requested, 0xff applied
Domain ID 1 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x40 requested, 0xff applied
Domain ID 1 MBA COS2 Memory Region 1 Maximum Bandwidth=> 0x40 requested, 0xff applied
Domain ID 2 MBA COS2 Memory Region 1 Optimal Bandwidth=> 0x40 requested, 0xff applied
Domain ID 2 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x40 requested, 0xff applied
Domain ID 2 MBA COS2 Memory Region 1 Maximum Bandwidth=> 0x40 requested, 0xff applied
Domain ID 0 MBA COS3 Memory Region 1 Optimal Bandwidth=> 0x55 requested, 0xff applied
Domain ID 0 MBA COS3 Memory Region 1 Minimum Bandwidth=> 0x55 requested, 0xff applied
Domain ID 0 MBA COS3 Memory Region 1 Maximum Bandwidth=> 0x55 requested, 0xff applied
Domain ID 1 MBA COS3 Memory Region 1 Optimal Bandwidth=> 0x55 requested, 0xff applied
Domain ID 1 MBA COS3 Memory Region 1 Minimum Bandwidth=> 0x55 requested, 0xff applied
Domain ID 1 MBA COS3 Memory Region 1 Maximum Bandwidth=> 0x55 requested, 0xff applied
Domain ID 2 MBA COS3 Memory Region 1 Optimal Bandwidth=> 0x55 requested, 0xff applied
Domain ID 2 MBA COS3 Memory Region 1 Minimum Bandwidth=> 0x55 requested, 0xff applied
Domain ID 2 MBA COS3 Memory Region 1 Maximum Bandwidth=> 0x55 requested, 0xff applied
Allocation configuration altered.| Bandwidth type | Region 0 | Region 1 | Region 2 | Region 3 |
|---|---|---|---|---|
| Minimal | Reg0 min BW | Reg1 min BW | Reg2 min BW | Reg3 min BW |
| Optimal | Reg0 opt BW | Reg1 opt BW | Reg2 opt BW | Reg3 opt BW |
| Maximal | Reg0 max BW | Reg1 max BW | Reg2 max BW | Reg3 max BW |
Note that to set min, max, and opt separately, three calls to the utility are required.
Example 5:
Use multiple domain IDs and memory regions.
$ pqos --iface=mmio --alloc-domain-id=0-2 --alloc-mem-region=0-2 -e "mba:1=0x50;mba:2=0x70;"
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Domain ID 0 MBA COS1 Memory Region 0 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 0 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 0 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 1 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 1 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 2 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 2 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS1 Memory Region 2 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 0 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 0 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 0 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 1 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 1 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 2 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 2 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 1 MBA COS1 Memory Region 2 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 0 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 0 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 0 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 1 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 1 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 1 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 2 Optimal Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 2 Minimum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 2 MBA COS1 Memory Region 2 Maximum Bandwidth=> 0x50 requested, 0x50 applied
Domain ID 0 MBA COS2 Memory Region 0 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 0 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 0 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 1 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 1 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 2 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 2 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 0 MBA COS2 Memory Region 2 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 0 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 0 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 0 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 1 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 1 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 2 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 2 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 1 MBA COS2 Memory Region 2 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 0 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 0 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 0 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 1 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 1 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 1 Maximum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 2 Optimal Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 2 Minimum Bandwidth=> 0x70 requested, 0x70 applied
Domain ID 2 MBA COS2 Memory Region 2 Maximum Bandwidth=> 0x70 requested, 0x70 appliedAllocate cache ways to device agents. The CPU and device agents can be printed with the --print-topology option. After that, provide the correct device agent in the IORDT cache allocation command. The usual -s option will give channel information and device agent information.
Example 1:
Allocates channel 0x30000 to CLOS1.
$ pqos --iface=mmio -a "channel:1=0x30000;"
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Allocation configuration altered.Example 2:
Allocates cache ways to CLOS10 for domains 16 and 17.
$ pqos --iface=mmio --alloc-domain-id=16,17 -e "llc:10=0xea;"
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Domain ID 16 L3CA COS10 => MASK 0xea
Domain ID 17 L3CA COS10 => MASK 0xea
Allocation configuration altered.Example 1:
-------------------- Enable IORDT --------------------------------------------------------------------------------
$ pqos/pqos --iface=mmio -R l3iordt-on -d
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Allocation reset successful
Hardware capabilities
Monitoring
Cache Monitoring Technology (CMT) events:
LLC Occupancy (LLC)
I/O RDT: enabled
Memory Bandwidth Monitoring (MBM) events:
Total Memory Bandwidth (TMEM)
I/O RDT: enabled
PMU events:
Instructions/Clock (IPC)
LLC misses
LLC references
Allocation
Cache Allocation Technology (CAT)
L3 CAT
CDP: disabled
Non-Contiguous CBM: supported
I/O RDT: enabled
Num COS: 16
L2 CAT
CDP: disabled
Non-Contiguous CBM: supported
Num COS: 16
Memory Bandwidth Allocation (MBA)
Num COS: 16
$ pqos/pqos --iface=mmio -r l3iordt-on -d
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
CMT/MBM reset successful
Hardware capabilities
Monitoring
Cache Monitoring Technology (CMT) events:
LLC Occupancy (LLC)
I/O RDT: enabled
Memory Bandwidth Monitoring (MBM) events:
Total Memory Bandwidth (TMEM)
I/O RDT: enabled
PMU events:
Instructions/Clock (IPC)
LLC misses
LLC references
Allocation
Cache Allocation Technology (CAT)
L3 CAT
CDP: disabled
Non-Contiguous CBM: supported
I/O RDT: enabled
Num COS: 16
L2 CAT
CDP: disabled
Non-Contiguous CBM: supported
Num COS: 16
Memory Bandwidth Allocation (MBA)
Num COS: 16
-------------------- Monitoring --------------------------------------------------------------------------------
$ pqos --iface=mmio –-mon-channel=all:0x30000
TIME 2026-03-16 12:40:47
CHANNEL I/O-LLC I/O-TOTAL I/O-MISS
0x30000 0.0 0.0 0.0
$ pqos --iface=mmio –-mon-channel=”llc:0x30000; iot:0x30000; iom:0x30000;”
TIME 2026-03-16 12:46:31
CHANNEL LLC[KB] I/O-TOTAL I/O-MISS
0x30000 0.0 0.0 0.0$ pqos --iface=mmio --print-io-devs$ pqos --iface=mmio --print-io-devs
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Enable I/O RDT : pqos --iface=mmio l3iordt-on
Disable I/O RDT : pqos --iface=mmio l3iordt-off
Reset I/O RDT Allocation : pqos --iface=mmio --alloc-reset or pqos --iface=mmio -R
Reset I/O RDT Monitoring : pqos --iface=mmio --mon-reset or pqos --iface=mmio -r -d
0000:0d:00.0 Signal processing controller: Intel Corporation
PCIe : PCIe Device
NUMA : 0
Kernel driver in use : idxd
Domain ID : 0x10
Associated Channels : 0x10004 0x10001
MMIO Addresses : 0x1ffff6aee000 0x1ffff6aee000
CXL Devices Presence : No
Monitoring Commands:
pqos --iface=mmio --mon-dev=all:0000:0d:00.0@0
pqos --iface=mmio --mon-channel=all:0x10004
pqos --iface=mmio --mon-dev=all:0000:0d:00.0@1
pqos --iface=mmio --mon-channel=all:0x10001
Available CLOS : 0 to 15
Allocation Commands:
pqos --iface=mmio -a dev:<CLOS>=0000:0d:00.0@0
pqos --iface=mmio -a channel:<CLOS>=0x10004
pqos --iface=mmio -a dev:<CLOS>=0000:0d:00.0@1
pqos --iface=mmio -a channel:<CLOS>=0x10001
After/Before allocation commands, assign required Cache Ways to CLOS
Available Cache Ways: 8
For example, set COS 14 to the first 4 L3 cache ways and COS 10 to the next 8 L3 cache ways in Device Domain 0x10
pqos --iface=mmio --alloc-domain-id=0x10 -e "llc:14=0x000f;llc:10=0x0ff0;"
................................................................................................................................................................................................................................................................................................$ pqos --iface=mmio --print-io-dev=0000:0d:00.0
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Enable I/O RDT : pqos --iface=mmio l3iordt-on
Disable I/O RDT : pqos --iface=mmio l3iordt-off
Reset I/O RDT Allocation : pqos --iface=mmio --alloc-reset or pqos --iface=mmio -R
Reset I/O RDT Monitoring : pqos --iface=mmio --mon-reset or pqos --iface=mmio -r -d
0000:0d:00.0 Signal processing controller: Intel Corporation
PCIe : PCIe Device
NUMA : 0
Kernel driver in use : idxd
Domain ID : 0x10
Associated Channels : 0x10004 0x10001
MMIO Addresses : 0x1ffff6aee000 0x1ffff6aee000
CXL Devices Presence : No
Monitoring Commands:
pqos --iface=mmio --mon-dev=all:0000:0d:00.0@0
pqos --iface=mmio --mon-channel=all:0x10004
pqos --iface=mmio --mon-dev=all:0000:0d:00.0@1
pqos --iface=mmio --mon-channel=all:0x10001
Available CLOS : 0 to 15
Allocation Commands:
pqos --iface=mmio -a dev:<CLOS>=0000:0d:00.0@0
pqos --iface=mmio -a channel:<CLOS>=0x10004
pqos --iface=mmio -a dev:<CLOS>=0000:0d:00.0@1
pqos --iface=mmio -a channel:<CLOS>=0x10001
After/Before allocation commands, assign required Cache Ways to CLOS
Available Cache Ways: 8
For example, set COS 14 to the first 4 L3 cache ways and COS 10 to the next 8 L3 cache ways in Device Domain 0x10
pqos --iface=mmio --alloc-domain-id=0x10 -e "llc:14=0x000f;llc:10=0x0ff0;"--print-dump-info shows available domains and spaces to be output.
Example 1:
$ pqos --iface=mmio --print-dump-info
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
Domain ID Type Space Base Address Size (bytes)
------------------------------------------------------------------------
0x00 CPU CMRC 0x00001ffff7fb1000 0x00004000
0x00 CPU MMRC 0x00001ffff7fc8000 0x00010000
0x00 CPU MARC(OPT) 0x00001ffff7fc1000 0x00001000
0x00 CPU MARC(MIN) 0x00001ffff7fc3000 0x00001000
0x00 CPU MARC(MAX) 0x00001ffff7fc2000 0x00001000
0x01 CPU CMRC 0x00001ffff7eb1000 0x00004000
0x01 CPU MMRC 0x00001ffff7ec8000 0x00010000
0x01 CPU MARC(OPT) 0x00001ffff7ec1000 0x00001000
0x01 CPU MARC(MIN) 0x00001ffff7ec3000 0x00001000
0x01 CPU MARC(MAX) 0x00001ffff7ec2000 0x00001000
0x02 CPU CMRC 0x00001ffff7db1000 0x00004000
0x02 CPU MMRC 0x00001ffff7dc8000 0x00010000
0x02 CPU MARC(OPT) 0x00001ffff7dc1000 0x00001000
0x02 CPU MARC(MIN) 0x00001ffff7dc3000 0x00001000
0x02 CPU MARC(MAX) 0x00001ffff7dc2000 0x00001000
0x03 CPU CMRC 0x00001ffff7cb1000 0x00004000
0x03 CPU MMRC 0x00001ffff7cc8000 0x00010000
0x03 CPU MARC(OPT) 0x00001ffff7cc1000 0x00001000
0x03 CPU MARC(MIN) 0x00001ffff7cc3000 0x00001000
0x03 CPU MARC(MAX) 0x00001ffff7cc2000 0x00001000
0x10 DEVICE CMRD 0x00001ffff6b8b000 0x00010000
0x10 DEVICE IBRD 0x00001ffff6b8b000 0x00010000
0x10 DEVICE CARD 0x00001ffff6b8b000 0x00010000
0x11 DEVICE CMRD 0x00001ffff638b000 0x00010000
0x11 DEVICE IBRD 0x00001ffff638b000 0x00010000
0x11 DEVICE CARD 0x00001ffff638b000 0x00010000--dump prints a dump for a specific MMIO space.
Available inputs:
-
--dump-domain-id=DOMAIN- domain to dump
DOMAINformat is an RDT domain number. -
--space=SPACE- MMIO space to dump
SPACE := cmrc | mmrc | marc-opt | marc-min | marc-max | cmrd | ibrd | card -
--offset=OFFSET(optional) - offset in bytes to start dumping from -
--length=LENGTH(optional) - length in bytes to dump -
--width=WIDTH(optional) - width in bits of a single dump entry
WIDTH := 8 | 64 -
--binary(optional) - dump in binary format -
--le(optional) - dump in little-endian format
Example 1:
$ pqos --iface=mmio --dump --dump-domain-id=0 --space=cmrc --offset=0 --length=32 --width=8
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
MMIO space dump: base=0x1ffff7fb1000 size=0x4000 offset=0 len=32 width(bytes)=1 le=0 bin=0
000000 b2 03 00 00 00 00 00 00 00 00 00 00 00 00 00 00
000010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00Example 2:
$ pqos --iface=mmio --dump --dump-domain-id=0 --space=cmrc --offset=0 --length=32 --width=8 --binary --le
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
MMIO space dump: base=0x1ffff7fb1000 size=0x4000 offset=0 len=32 width(bytes)=1 le=1 bin=1
000000 10110100 00000011 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
000010 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000--dump-rmid-regs prints RMID registers for selected RMIDs.
Available inputs:
-
--dump-rmid-domain-ids=DOMAIN- domain to dump
DOMAINformat is an RDT domain number. -
--dump-rmid-type=TYPE- type of RMID registers to dump
TYPEformat is a name of the RMID register type to dump. -
--dump-rmid-mem-regions=REGIONS(optional) - memory regions to dump
REGIONSformat is a range or a single domain. -
--dump-rmids=RMIDS(optional) - RMIDs to dump
RMIDSformat is a comma-separated list or range.
Example 1:
$ pqos --iface=mmio --dump-rmid-regs --dump-rmids=0-5 --dump-rmid-domain-ids=0 --dump-rmid-mem-regions=0 --dump-rmid-type=mbm
NOTE: Mixed use of MSR and kernel interfaces to manage
CAT or CMT & MBM may lead to unexpected behavior.
WARN: resctl filesystem mounted! Using MSR interface may corrupt resctrl filesystem and cause unexpected behaviour
RMID MBM DUMP:
DOMAIN ID: 0
MEM REGION ID: 0
RMID 0000. Value: 0x000000000fa7fa8e
RMID 0001. Value: 0x000000000737d0dd
RMID 0002. Value: 0x0000000000000004
RMID 0003. Value: 0x0000000000000000
RMID 0004. Value: 0x0000000000000000
RMID 0005. Value: 0x0000000000000000