From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=pass header.oldest-pass=0 smtp.remote-ip=52.101.53.37 ARC-Seal: i=2; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=pass; t=1794259491; b=qXoU3kDatQFPWMsnBnnIKBsIX7HiVPynZddpCGZnaoWzUKaKDKx6w3/nXOJd+G67IyMp 3diRY7GtV/Kjir+F1RaN7RaHwNXxG0UBhu3kgKLWVybCAahWGcq+0md4cyF6w7Ls8ec3I FevStf3m3dS3MBmYag1Xx4Q/RNJ0gBIwyb/Bfe7uzmz6OoG2ckcBMx3jSh3Lgmuyf0tDH 7VdXm8zZW1dnQGasE50QOL7KUeBUceoHrKJiawjyC+J1Iq1lDc5RqWTA7WLgXHfaFZpgA 1NQvHHK6ZlJ5E8oXpX+bYZoutPCRhxcumQhBuLY9NArKkpudqHJOxwq/Pi6LNjAUDfQ== ARC-Message-Signature: i=2; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794259491; h=DMARC-Filter:DKIM-Signature:Received:Received:From:To:Cc:Subject: Date:Message-ID:X-Mailer:In-Reply-To:References: Content-Transfer-Encoding:Content-Type:X-ClientProxiedBy:MIME-Version: X-MS-PublicTrafficType:X-MS-TrafficTypeDiagnostic: X-MS-Office365-Filtering-Correlation-Id:X-MS-Exchange-SenderADCheck: X-MS-Exchange-AntiSpam-Relay:X-Microsoft-Antispam: X-Microsoft-Antispam-Message-Info:X-Forefront-Antispam-Report: X-MS-Exchange-AntiSpam-MessageData-ChunkCount: X-MS-Exchange-AntiSpam-MessageData-0:X-OriginatorOrg: X-MS-Exchange-CrossTenant-Network-Message-Id: X-MS-Exchange-CrossTenant-AuthSource:X-MS-Exchange-CrossTenant-AuthAs: X-MS-Exchange-CrossTenant-OriginalArrivalTime: X-MS-Exchange-CrossTenant-FromEntityHeader: X-MS-Exchange-CrossTenant-Id:X-MS-Exchange-CrossTenant-MailboxType: X-MS-Exchange-CrossTenant-UserPrincipalName: X-MS-Exchange-Transport-CrossTenantHeadersStamped; bh=NwqgeVLFMAw4H+tW72jySvQLUb9zUD/fSahQOrxSoNs=; b=3emdlNQHgO0bHO8BrL//1hOe8ErLurL90GQH8487RErlHyr8uBG/O9wVFDKbh1M1cZ+p 13F8ILwgC6iGc9CqYrf39YPTJ/A92jejKJ1dJusHth+gEm64BM1vAYGx1sjyEQyGEAcWd oLLb0LCkWttX94mxC3jJdOxNXcIypeQ8FD71KWniG2RwPXgd2OzxIQnK5GG3C6x98DHeT CGt9+DYn2WJrwoACTpOvJqCKF9pppMzbAfqPuvkALRM9yj1ZQkDvKyGJ3knajv4r2GEIU R1z5Z9e1ULjHncEdeuXmWGeJ90g6iUw8ZmAm4TyDcvccJoQE7HseOTVIcu8cH5082hg== ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass header.from=nvidia.com; spf=fail smtp.mailfrom=nvidia.com; dkim=pass header.d=Nvidia.com header.i=@Nvidia.com header.a=rsa-sha256 header.s=selector2 header.b=SJ0fPz8C; arc=pass header.oldest-pass=0 smtp.remote-ip=52.101.53.37 Received: from BL0PR03CU003.outbound.protection.outlook.com (mail-eastusazon11012037.outbound.protection.outlook.com [52.101.53.37]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (secp384r1) server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3D9DF60A262D for ; Mon, 9 Nov 2026 21:24:51 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 3D9DF60A262D Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=nvidia.com Authentication-Results: smtp.subspace.kernel.org; spf=fail smtp.mailfrom=nvidia.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key, unprotected) header.d=Nvidia.com header.i=@Nvidia.com header.a=rsa-sha256 header.s=selector2 header.b=SJ0fPz8C ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=h+fyS9vutkwsa3cz7jOT6/1MoRq2F+vKRxXeQXY7tSw2Bb9Bc2WCDrcYOK6EGs1kPI5f2gpSe5Qq9/NhyAxmM4rvY5OGvvY2Frri4+PheLvaWVWGXEkob3H2EBHvhTdHDjjEgCi2wyb+QKdGQV1ybF0eVhubSg7APgHrSLeqrHsQIhFcJ8dn9pJ+3MaL/EV8wtIa/r5h/g077hRZGSqVYKNh79awMlL+NBfJNcGauj3GlnhGg4KU2cFXTqBUbXjF72Ttqo1RDviajNv4msvw1b1gRd2t+eH+S2KPFMxUzoAs7eyidBASj/ZYWwSFlafVp9JGgesr+9eFFWdrwFj7ZA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NwqgeVLFMAw4H+tW72jySvQLUb9zUD/fSahQOrxSoNs=; b=N0DCg+APl0FoKsglnrw8qsdUWX9AddyKCxRDltNrWq6IhKh5DIW0NxnDIA38SCfoORz2MSMyAWchs7/JQk4gtzzE0FGUBPlChCQMUPivniJR57+bvkvnTvCB2retB5gsxziXaKWF5jKIlqUXNJDPiFAUtsa8izQEME8GTGA5lxV44jmWS/HNmGq64aCfJogOWD6HcozmM95VyqScZNx+EWINMISdiatTTloxYsLnGFif4WDo220gslsh5Wv2rszguzBBi9Lw4h62vvLyDXZ10TnBmMkGRadedtpTO49dNXzcZ2Ck2gkyHHL/IPRzHhUd+k8gjR3O3SyzsmB3xwuMVg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NwqgeVLFMAw4H+tW72jySvQLUb9zUD/fSahQOrxSoNs=; b=SJ0fPz8CaoCfkvrBBhPA1f/JilQ/M8fMWyTt8dl/ZleMwwAPzDwZTWFB1jVWG3E0X2+UHkAXhwTPMf61N6/n3jkQrcxPzEGm97Y6ayfB6YejTfB9jy9oNHrnHTeIWT3ncrVjoPtb547RgTWLZ8ZGVkRQSSDm0Y/qggEgbnn/s1gVUPZ1pMO+UBHRjTXCSCBtXlffcBVUnS+sdEEKio+tlD30sKtvGjNM8TsWcXeuxqAbtdqziWhcW0yNw3awj7i6OQaKx4sheF9DYXSiZYZM0VsJ8ErQixY0LaMezD0kWUFtOZnuo1uuP9td7s88YopZxt7f3Ejh34yI3u7wBtf1Yw== Authentication-Results: mx.microsoft.com 1; dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nvidia.com; Received: from DM4PR12MB5230.namprd12.prod.outlook.com (2603:10b6:5:399::11) by SA3PR12MB176418.namprd12.prod.outlook.com (2603:10b6:806:513::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.592.13; Mon, 9 Nov 2026 21:24:48 +0000 Received: from DM4PR12MB5230.namprd12.prod.outlook.com ([fe80::6e87:1bde:1853:3b73]) by DM4PR12MB5230.namprd12.prod.outlook.com ([fe80::6e87:1bde:1853:3b73%4]) with mapi id 15.21.0569.011; Mon, 9 Nov 2026 21:24:47 +0000 From: Fenghua Yu To: Reinette Chatre , Tony Luck , Ben Horgan , James Morse , Will Deacon , Dave Martin , Catalin Marinas , Shaopeng Tan , Chen Yu , Babu Moger , Drew Fustini , Vikram Sethi , Shanker Donthineni , Newton Liu , Richard Cheng Cc: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Fenghua Yu Subject: [PATCH RFC v3 12/15] Documentation: resctrl: document mbm_NODE_assignments Date: Mon, 9 Nov 2026 13:24:24 -0800 Message-ID: <20261109212427.1409204-13-fenghuay@nvidia.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20261109212427.1409204-1-fenghuay@nvidia.com> References: <20261109212427.1409204-1-fenghuay@nvidia.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: SJ0PR13CA0024.namprd13.prod.outlook.com (2603:10b6:a03:2c0::29) To DM4PR12MB5230.namprd12.prod.outlook.com (2603:10b6:5:399::11) X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM4PR12MB5230:EE_|SA3PR12MB176418:EE_ X-MS-Office365-Filtering-Correlation-Id: f77b83de-23a9-4c9d-871f-08df3ea7e19f X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|7416014|376014|23010399003|366016|1800799024|921020|11063799006|261028144727099003|261021123027099003|261021121427099003|261022105027099003|261009223027099003|261026121527099003|261026140227099003|56012099006|261102123227099003|22082099003|18002099003|6133799003|10067099003; X-Microsoft-Antispam-Message-Info: lTkZjqZ6eaar9DpXn4/7Vh3ZBgIskrv5tTEsx0bKTYwJ7av7vlWABpIsWbJz6NOyY7iaiWQzmE9pFZHzyC4bFU9jB8l2KUstw8NlT/Y5NwGeUIcmnlH08AXl5tSMgRTFI6Bc7ETy/i3ZXVJuocRzv6QQGO9Fur/lYsOisiribEfllzQmk6Q5rKb6pyf1cMUER3LuKlwrEoRDNE3zVnAlN31hlY+WfpjnnN0MK9y5RVJEx16quoQw4fO0VWEr2e849dvcsmPu+nJkU5a8dFR1oyfydCPjjFTlHfQD9vvTqqGqIJnSTKKTM5KxVJKpDMKvc0IGmCSDL0wTm7r3XgO/Q8iOOy/Ad/TdrD0JrAIWsRZ1iUmVxxr+dn4/zveE+gp0ycdrLpuVzxDhJpntucZG1Kbx9FZ9wrg9SQgPziBu0Cj20M6rTKarFEHYDEVhq9czYkh2LtM8M1mKRCpz+MBK64wbRQmycIOe7HUxzGXZOL6ePWopkQqb9Ka3kufvIY+1c3CdjBvGzoI9xx6b87GDJUFwlcxrYK2y8XtV9nGub7A43l5MuiQLDMsjT3CysvwGFYVV9e85Td2DNm0yPpB37I90L7+tcQ4IZSp3lufiDlhKL30C1+hV0nxoezflWO/0AygkH/dnyjluHM4pj588nZq0Qx59cv4TrsS9rpbFHMj5P3nSy1O/nY3UNKD1/ztX7oG5cejMV1GktPAmD/WgYQ== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM4PR12MB5230.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(7416014)(376014)(23010399003)(366016)(1800799024)(921020)(11063799006)(261028144727099003)(261021123027099003)(261021121427099003)(261022105027099003)(261009223027099003)(261026121527099003)(261026140227099003)(56012099006)(261102123227099003)(22082099003)(18002099003)(6133799003)(10067099003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?ii+d4ToiQ7gF4W7EeuIywDfNLxEZSM3TmU2Z1q2p14LfjpVBz33bmVuUvVzl?= =?us-ascii?Q?4heAXAGqvZJNze2sg0ZbcQpNCzJYjvorRMs1uEmkcENIxp8usiwhQqzJL67+?= =?us-ascii?Q?t1rHPvd1ixDkNqDJbKMP+mPkz0kWn/iL9wuldriyQeOD29ycX7Onr9c9CbK5?= =?us-ascii?Q?+puAGymKoTAQmHAeiZ4jEy14ZgLWjQfwkfVfThDJQHJXWQVmOxV4xm1czXv2?= =?us-ascii?Q?pXvr7kilWpUZChkcNYUhWy5f+Nx71bOreJnEEcs9Lu/8gW2oBhj6qlSZoG+g?= =?us-ascii?Q?WwjmwVBgQHeG7hLJ9vR18PFOn52iuSKaijf5bbsuM2ou1iM1fdgfie4KnusA?= =?us-ascii?Q?+WzC0D/TKYZz1f932QrUbzE3UQQ5Mh0neeB1WwginXnnShA1AVsY/bnYYoNv?= =?us-ascii?Q?0qnZjpgtJPOhkf5QiVR51FXeN/xcrOjImwT1mYodY+bN5FI7EuysgjirxtQa?= =?us-ascii?Q?IpQ8oK6VHWQFo7UeyrRmd5W4+spkK0XSMHpfcD6lZI9rAiPpETd3XubIcNaC?= =?us-ascii?Q?q25FaELYmTIQ1ZqJluQXQIHcqSKd3KMvND6FyNnYvxOnK2kQKgYmmpEpohXF?= =?us-ascii?Q?CAnt79kV/zyDzvFjCYqiDk9eOt/W9WFK83eETuxbu0KdBeyMTBAZZ1HqdgrJ?= =?us-ascii?Q?sddNg7k0F7PnVPleoIhB7Mf6cn7ZXB1V2B1xRVa8i8a5Lwg9fRNPITI3rRec?= =?us-ascii?Q?Q1A9+04jMoOmwQK/k6LpHi0ZtqlV+GXMaff/s2A5HQK7tvUfrrGisPsUYwR4?= =?us-ascii?Q?md3o+HvMS9+nsHf2QJ6HoW/8oShFLuci//o6Te0kiSijQj6C59hjL7tq5YOM?= =?us-ascii?Q?vFijL0KGdPcIa4OKTx+jZDVZbfAjv3Xi8edmodavAWcWHTYdsTC0uE1BiGTO?= =?us-ascii?Q?X+jDIzI208B1kkXfViMpv7B5cneJXhoE4YFPFZAKsbccRGaDdmG417APKOZQ?= =?us-ascii?Q?WC2l+Kw9f4rVuq6rnKMZ2P2xqqVS9lyDg9tq6Q9Lr6hPByKUmimdlvkeKLxb?= =?us-ascii?Q?0kwxaWAIrthYAWdqW0M3HyVFlWXoHCMIWbx6M9zpvAoxNEof4F1MPk1PhgPA?= =?us-ascii?Q?MTDBq4xxfyw+ptRc/ygLIYD5XPJRnkkR12mVM261IKy7Xm1I+Cjx61DaFzE9?= =?us-ascii?Q?0hmrv/BHbPaW6+qgxhiNNMmTU8Et4vAjZdGn3sMjdccVYlnxF3VxXJf1jhpP?= =?us-ascii?Q?qG3tjrgSgoIZmD8SYzU0Mq215PC61qvNZ4kE0a7O4lDrchmvRWmX4RcxuGyf?= =?us-ascii?Q?AWLRAOqr3dePwIyFZosi6xX6afHRv8QPy9d1GQ68AYfEjKIhyBc0iDs5fLVf?= =?us-ascii?Q?v2put1T5P6FQHa1R8LGj46oKLEm/dVNtPEFRYL8ieB+G2r44/vdhG7+XI9BH?= =?us-ascii?Q?vM+YuJ+2wxTOwiXyjJBuTFy+TFnU39ZNM1bm5ifGFhwlFvTboCiXDni4UtVE?= =?us-ascii?Q?e/RNQwIzi4Pe1efSF5ffWHGsL4KVTEmcs6rjOfnO0s04dvRyjd8i+ndnFb1p?= =?us-ascii?Q?IzH9h0Vx4IQsU9wKDXnd6A16fpOzdcExNoTRkGoR7EVz3Jmb2pPXvaWe2obx?= =?us-ascii?Q?PrIyvIcu5A85rSo1eZ1hkxD81jMc0p6+pxg/dIlse0bgxkzihdZVjShdXfeL?= =?us-ascii?Q?KrA3Ax3uyMhCCoG03PdT/M1bbrgcOy71Mya/uMqw5YbpIojJQw3CwBSZe9vE?= =?us-ascii?Q?Nelbp9QvGQ2BPOi7Rtjj3ygZE37eGU0wHKTdYDoBxPdZu0j3rCx4gdsHyCD3?= =?us-ascii?Q?znAVTOgrpg=3D=3D?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: f77b83de-23a9-4c9d-871f-08df3ea7e19f X-MS-Exchange-CrossTenant-AuthSource: DM4PR12MB5230.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Nov 2026 21:24:47.7410 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: EO2qJ6G2BuKPFAbPqGJtVRKqx6xfjZ38PH37rNbVZo7PznKB9HKR12bcxo9XXYqIbh26MOH5McrKZDt/lm97IQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA3PR12MB176418 MBM counter assignment uses mbm_NODE_assignments when the counters are backed by a NUMA-node MSC. An L3-cache MSC keeps mbm_L3_assignments. Document both files. Signed-off-by: Fenghua Yu --- Documentation/filesystems/resctrl.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/Documentation/filesystems/resctrl.rst b/Documentation/filesystems/resctrl.rst index 434e6f42db4a..6ead819a7a2a 100644 --- a/Documentation/filesystems/resctrl.rst +++ b/Documentation/filesystems/resctrl.rst @@ -550,8 +550,10 @@ with the following files: the user. Each event within a resctrl group can be assigned independently. In this mode, a monitoring event can only accumulate data while it is backed - by a hardware counter. Use "mbm_L3_assignments" found in each CTRL_MON and MON - group to specify which of the events should have a counter assigned. The number + by a hardware counter. Use the assignment file in each CTRL_MON and MON + group: "mbm_L3_assignments" when MBM is backed by an L3-cache MSC, or + "mbm_NODE_assignments" when MBM is backed by a NUMA-node MSC. + The number of counters available is described in the "num_mbm_cntrs" file. Changing the mode may cause all counters on the resource to reset. @@ -859,9 +861,12 @@ When monitoring is enabled all MON groups will also contain: When monitoring is enabled all MON groups may also contain: -"mbm_L3_assignments": +"mbm_L3_assignments" / "mbm_NODE_assignments": Exists when "mbm_event" counter assignment mode is supported and lists the - counter assignment states of the group. + counter assignment states of the group. "mbm_L3_assignments" is + exposed when MBM is backed by an L3-cache MSC. + "mbm_NODE_assignments" is exposed when MBM is backed by a NUMA-node + MSC. The file format is the same. The assignment list is displayed in the following format: -- 2.53.0