From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 627A43469EE for ; Fri, 27 Mar 2026 16:26:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=198.175.65.17 ARC-Seal:i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774628775; cv=fail; b=oFzQpqv4pKTdXgsGajcxGu/gVx/MOUVTEiwMB4ebTKitwESfu5A0ZWMVRfuC6aFOKZcDm0sUzwOonUiAEPr8H7batFzcWdvEZZC7LoZEZbTdmlzwjzZ42VrbybRtoVjSrVYR/IeA++gSHNZ3wx9IMOlwG1Sj6q/JMnDhN4L4N8g= ARC-Message-Signature:i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774628775; c=relaxed/simple; bh=gqtHURFa9tudTnKgrYxTEVm8jzoD/F+0I3f+o0zkTH0=; h=Message-ID:Date:Subject:To:CC:References:From:In-Reply-To: Content-Type:MIME-Version; b=QG4kDe8N+WuUQYdR0yQjIB18ajHOtXFQE9ZWOHjFu5PCqakhMcAWo7Od5vLUQGFRpz9JdKFo+3IZPTDpmrG+J0DhBzZyQc8xDTttf9b3FmgvbeuY13vF79Ten+ryXxeDD5+HbZlAu7C+J8Wi+hhAocIVYGKhDzYUJzDMbRrz/j8= ARC-Authentication-Results:i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com; spf=pass smtp.mailfrom=intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=bePMnZp4; arc=fail smtp.client-ip=198.175.65.17 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="bePMnZp4" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1774628774; x=1806164774; h=message-id:date:subject:to:cc:references:from: in-reply-to:content-transfer-encoding:mime-version; bh=gqtHURFa9tudTnKgrYxTEVm8jzoD/F+0I3f+o0zkTH0=; b=bePMnZp4jE+0hDIbr2WPGnfn1RD/O0TBBa+4Y15AHAmfKty8BYfw7mQv RSJ7wXUG9d5DuZhWnyVYy6uYn6+JTtU/KW2fzTJa3b7kWQCSzguJuF15C UTWvd3Hi1wR1zKXVmAiqzcAnNN+Lx8ey96sGrd4ZJJvUuZ3ZaIdzui4Lp DZSQiONKmwEmM5tGhyhFM0IROtpvZ2Rp7lN4eTUh28q+hBOy9ym+EdWZZ B9SMJIuikHggmE/+ngqsa1Ntvz1Ufff60Y61B2rbNoSwiby/YHSbi9JdO DsVhfcb3J9tggX3Z565v386mkxcCDeSAtnzcOKdoDCNBVMqT3viBlAo8H g==; X-CSE-ConnectionGUID: wPM1Q/yRQ2KRFUe/e3DlIA== X-CSE-MsgGUID: uvJR3difSmGCb+vDksd2sQ== X-IronPort-AV: E=McAfee;i="6800,10657,11741"; a="75673140" X-IronPort-AV: E=Sophos;i="6.23,144,1770624000"; d="scan'208";a="75673140" Received: from orviesa010.jf.intel.com ([10.64.159.150]) by orvoesa109.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 27 Mar 2026 09:26:13 -0700 X-CSE-ConnectionGUID: D76sHVm9TBW9r3OhQYeMkg== X-CSE-MsgGUID: kvtp1n65SWmsFRhyD2qzRA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.23,144,1770624000"; d="scan'208";a="224567309" Received: from orsmsx902.amr.corp.intel.com ([10.22.229.24]) by orviesa010.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 27 Mar 2026 09:26:13 -0700 Received: from ORSMSX901.amr.corp.intel.com (10.22.229.23) by ORSMSX902.amr.corp.intel.com (10.22.229.24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.37; Fri, 27 Mar 2026 09:26:12 -0700 Received: from ORSEDG902.ED.cps.intel.com (10.7.248.12) by ORSMSX901.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.37 via Frontend Transport; Fri, 27 Mar 2026 09:26:12 -0700 Received: from PH8PR06CU001.outbound.protection.outlook.com (40.107.209.2) by edgegateway.intel.com (134.134.137.112) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.37; Fri, 27 Mar 2026 09:26:11 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=cTwbivEFqP+qtXoxzMiJuVaZ9f7lajoY2sSFEdXXI1Creoek/CLdC34Tg4X3mILFFOwfx/S5faKHg+W/U5UbrAQWYFp4W3UeZoD+wE8WgDKxZWM/FIMoJshzf0LMyT7HV7HuXBRbKOD+X8dHgCa6bt2wL6OGtAf2DP0sRBgkNfZ+tSIqPVfhksKXz7DgPl2W/nN5pkpso5IFO12W3a38PVwmbxH/DZIohUnGvnqccCW5w6OejV8p1MNqtl12JDJyVKl3UQwm66Ot4IQ/D5WcyXwc9Hj2O5sp5UkhFaQ282dHH45UTh7y6koCw1Kcop18K1eV7p9oR4aL2q5NeHLJ1Q== 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=/jAD/VVnRer3GAQ5/71D091PdKy3UMkosppd3yaWG6w=; b=HXPE2XHsKWqGuhfsixgMz2kCdQVpGVf4F6Mr097Zft6MdC8Z38lom3PkxNXn1OeeYyIVP1V1iWsi3wHoPgVAmz/3S32/ggFT6PD2fC/n8GgWr1xpczpRAcc9/IillXxbI3KJYtBAFbRnT80ZtN9xg6gJADZ0RwRFBNL7IocuYzVf9Tz173XS8ZjoUxtvlIo/1jrxpFFQhXpSQV0Fj88+IH0EzYcstjVSWjCfBBuhO8gMmxtYAf8nZEa5nhYGDLYApkd1ITZ8y95sYTmYsVSR7SgSA6MjY6+AMWFtdoi/WRGVFUFk/nVFcFsHOANW6EWVDJXqVQ0Feg9Gzd0ZmFQOTw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; Received: from SJ2PR11MB7573.namprd11.prod.outlook.com (2603:10b6:a03:4d2::10) by MW6PR11MB8367.namprd11.prod.outlook.com (2603:10b6:303:249::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9723.19; Fri, 27 Mar 2026 16:26:09 +0000 Received: from SJ2PR11MB7573.namprd11.prod.outlook.com ([fe80::bfe:4ce1:556:4a9d]) by SJ2PR11MB7573.namprd11.prod.outlook.com ([fe80::bfe:4ce1:556:4a9d%5]) with mapi id 15.20.9769.006; Fri, 27 Mar 2026 16:26:09 +0000 Message-ID: <8d51eef4-c52c-454c-b1fc-89549e544a13@intel.com> Date: Fri, 27 Mar 2026 09:24:35 -0700 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v4 6/7] fs/resctrl: Document that automatic counter assignment is best effort To: Ben Horgan , CC: , , , , , , , , , , , References: <20260326172551.1553871-1-ben.horgan@arm.com> <20260326172551.1553871-7-ben.horgan@arm.com> From: Reinette Chatre Content-Language: en-US In-Reply-To: <20260326172551.1553871-7-ben.horgan@arm.com> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit X-ClientProxiedBy: MW4P220CA0019.NAMP220.PROD.OUTLOOK.COM (2603:10b6:303:115::24) To SJ2PR11MB7573.namprd11.prod.outlook.com (2603:10b6:a03:4d2::10) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ2PR11MB7573:EE_|MW6PR11MB8367:EE_ X-MS-Office365-Filtering-Correlation-Id: 1ea66bde-fefa-43b5-9086-08de8c1d8de7 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|7416014|366016|1800799024|56012099003|18002099003|22082099003; X-Microsoft-Antispam-Message-Info: Z5SPHedaqPDC6zrkTxl79ESsiIAR9tqndXHfvOVd47snLfjGOXb2FiMJ2t95H7sUMmaIEjkr0B6leqklvPC1irmO2yZSI9Cg3j2PAyprfOxxmb6VfvCWDziUGQg86482KO5Sga/xuyv3CfFtCiXq31JREgW6bEyMbBxG0kK5EceRgSuAbJjPodYY1hE4XK/cW39BcNM+6dgxT30nu3z6YKCsMu42stdX3aaIr+tOHAzlv6aNiz6Zbl70tU1esEXFrj1WQeao98hN+4JEEWVb9RNS5Qn/sCDfGlPeM60lv17jNaSWaRcpT9kWhtERpKt1luupspXQ5jWfAMTGHG3SdLUuRIqKdEWn7UpWymKW8yA+XWZKHPreSyB1nCemJO0hPm/TTGq4Kwqj16DJubbpnLhm0MJpiEXY0tUYDcSe9OCBrvXeiaC8CuPM0A8ObVsKYftr2TXaghdwYs96Z96vStzJKGln2bg6Hi+7fw9c0a8WAH3ey0KH8xYN+eXLmfIXpolLd/ID1fjpOVpg7fmp6fPX3TLcTLaElRv3tLlDeiZQdJXqOj2GHS+Nz2qGif0RBAQ0gRfUOEgT2r92/1G/afMIIIheoIcYS21TeVthjExAqWhDX6TKx7fRypNost6+SLWY89hzJd+G8d3zj4/V6bI97zK1nqj5R9f7Kewz5fcUM87H1xqRcNSqK14LMmlrtPYrL0kUPHT/aZH23SPDsmdzzWojcSfPx3TFCEOHOJU= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:SJ2PR11MB7573.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(7416014)(366016)(1800799024)(56012099003)(18002099003)(22082099003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?OXRVL0FOYXJtWW5rZDQwSVltczl6Sy9IU0ptWjRzWUR4S3k2dmZGWjBTV0g1?= =?utf-8?B?ZEhDbU4rSlQyVTVYOUVnbHZkZmpPcjczZGpIOFVQeWR2QUhreWZrZWJBbE1p?= =?utf-8?B?VnZXU2NHQWN2c09OTWltdVpoTzhRSFMwQWFzbEZyK3ZuKzV3RzFodmw5UFls?= =?utf-8?B?dVBXME9UdHBOM2t4SE1xNjdYVkFFVDRiZUFXdjVqemdGRldSR3kvZlppWjll?= =?utf-8?B?d2F2d1hBb3ZLdGp3WjRmMS9pejE5a2Rkb0E3V2w2dXJSTU5XbWNkbkVoUnBT?= =?utf-8?B?WHVUSzIwVFh1M2pFK1FaLzd0L3RSdUgrNnNBN0dTNjJ0dDFDa3pQdVZBNER2?= =?utf-8?B?VFA3N1U0OXkrTXdDSDY4Z3FKSVRKbHVRRWNmNVV2OHFKSThrbWJ3TDMva3dE?= =?utf-8?B?MEk4QlBHdzJSRFRQemJ0WmxDTkQyeFJJMURDOHdZenUzbWF5SktEdE1QcTJU?= =?utf-8?B?bDVKQXpXYkZsYWpYc0xJMFR1dko1TWhoaTlLNk1hajhxb3RNdU5uYUZ6cnh5?= =?utf-8?B?NjlJcExxaUZOWHZtS0xPZGh0RDRQaS9oZGp5SjJLNjVxQmxWdXBVRWdVSC9m?= =?utf-8?B?UWN5ckNlcVNnd1ovM3R0QXk0dDRJdWRYeDZCSVorK2wrTnpaRGpKRWowR2Rs?= =?utf-8?B?OWxWL0FVekhpakkzZU1FcnhDQVp0ZHpQZFVCdjgxUXNaM1g3bHpoTmpsQThD?= =?utf-8?B?NTJaODBheXFsazhKSjdmcWVuL3BrbUhhZnhwb2YzSlYySVo3dCswZUlmajd1?= =?utf-8?B?QXV4aHBSS0IzN1E5a1JjVVBzUGpjNlpuRVV3WDVKeVdvWTZpWXR3ejl3VGhZ?= =?utf-8?B?ZzNWbnNwM2M4YUNyVjIzcTk5Q1gwWW00YjVOeVVvc1ArU3JNVThaY1dKYmJU?= =?utf-8?B?eEVRYzEzSTBicDJaZTRuL241WWNydm5ZY3RiZEt3VS9XSUppNzVyaThiMnBP?= =?utf-8?B?RWlaSnRlbVFTYVZsN08yc0hqeWFzUDljVE1NaXc2OG1Ndk5OLzBrSGxiU3A4?= =?utf-8?B?dkZxMHhRdkFMdVdPdUZLRWxwWlg2MUp3NnBDQmwvd21VZmYxYXJzemd1NytI?= =?utf-8?B?ZU9yQmZ4WkRiUHNLNEdnRnBmWms0V1FucU92NGxhR3NQUHB6MlYybk5aL2Ro?= =?utf-8?B?eFFXWkpoa2JwWGtjU0I2OWM4K2U4Vmx6ZHFoSm40Q01CR0FEejVObGp1QUc5?= =?utf-8?B?c1RKdHpEWnRmWXdCc0tsSmQyRVZrTjF5Q25iQURVZUdIZzdNSjYxcXYzeWN3?= =?utf-8?B?ZTNKTEdNOHhrSE14ODAvSDRHTEtiMUp0amNBNENMR242V3ZldHBmVXlLWFV4?= =?utf-8?B?UUJHcHVIaERydWl2eHV4L0dwR1NZWktOMVRZZW5LaHdjdWZiY2hsYzgycHdM?= =?utf-8?B?ekdZOVRMV1U2WVkwdUJlTHZpeGk5Ri9pY3J1bHJKK3NwVU9yTzdQZXhHTGI1?= =?utf-8?B?NnV0ZU9sOFVnK09scDRleDNwUkNGS1ZMemdZRHdONUR2ZW5HVm5sNjN2N3Fv?= =?utf-8?B?NGFPc0hUL2JVUEdobHFvTUNGUUFzUmc3anRxUlg4OVM2V1M0UXdrNGFhWmdt?= =?utf-8?B?NENxbmMxRkhXK0dWZENmVmxJeDNFQTEyTklxTmllaGM5L0pEU2FpZGdhSHhu?= =?utf-8?B?a3hJRWN1aDVBbVd3TEFDQlkzK1dRWm1SOER3RkFtQ1RSd0lSMVBzSHZXakp3?= =?utf-8?B?VFdneGhYRUdoSU4zcHQ1T0s0Q2ZsZlhQL082cjU1V1pLcGdqZ1BxTVh2bGhX?= =?utf-8?B?b01WcTAyY0pEOWdlZ1VBM1c5cXRFVnVIV2x2a3MyMXdSdWM5UFRCVU1VVWJI?= =?utf-8?B?QnRkUEMreWhmV2RIdVJzL1NIT3lWVHhKTmlrSXRIcmp6ODFRcG9UbmwxUlBD?= =?utf-8?B?TGxMS2NMWm1kMkM1cXllOGxpcmZBazd4bkNaSFlMZStIV1FsNkRYTzRyc0Zz?= =?utf-8?B?MWlwSmJFL2k0cXpmQjJPMnlKbXZGc3JDZ0hpMHBFcC9iTkRUdUlCZVFOWDA2?= =?utf-8?B?bnZMbTd1UCtRR3oxUkp4cXJOWFlWSGczTjlCYkwxRmt1Y3lPV2R2dFl0M0N0?= =?utf-8?B?T0JYWktXOHpXRE92alBBR3pCYkRYTEFFdERPQ09nYnFDYjR3TWwxanR1WVBQ?= =?utf-8?B?WVNZeUNnQXJMMlJrK3Vyc294eE40a2dTZmQ5SUwzWWpMSzhGMWFSMXhFcTdy?= =?utf-8?B?OWViRUF1Q1NnKzMwSExTRmZDTlNTRE5Fd0lZWUlCbm9oSVZwYWFiSWxGaW1Q?= =?utf-8?B?Y09kZCtvZmw2bTI1bzk3NnFCKzlPZjU3dGthckFCV1ZIejZDNEdyRncreklR?= =?utf-8?B?L2NPbkh4Z1JFaEFCaThmMHFubnJrWkxuYjNwRnpVdE84T2dFNmRTTDArRmsw?= =?utf-8?Q?Ltc8GnMq0qLY2WmU=3D?= X-Exchange-RoutingPolicyChecked: MGucIXSlDSoCMpUB5IFWCCfYNsimDZ6It+l7e4MCRcs588cG+HQQoDhz7KFYkARfsuwgGFKAGQhGbblcS2n10Xx3w/15JHqyThB8S6W6YGDNS2djaX7q1Vzc6mKA2G1edYqoxkhubuhctayVEbp4BKztqqKK2+UzoF3RnGb/OVozFhpAlJ2XD3iknlyIflfIxvG9353W33b8MtK40XZgRVs8yghSjqz6DWbVeZX0KWdAWMfTyqlTIXztm0S8TWzdcX06N8HoBruDwhUlLSkAP+0nPn36CgRZeQAlaPvhSs1eqmEta84YlUYGBlVJ9mYYyq6mN8HDk8aGbjQUdCphIA== X-MS-Exchange-CrossTenant-Network-Message-Id: 1ea66bde-fefa-43b5-9086-08de8c1d8de7 X-MS-Exchange-CrossTenant-AuthSource: SJ2PR11MB7573.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Mar 2026 16:26:09.7470 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: OukjCXBDoyxboyCY35swK7Igm8ugdo3SHbR4+LTnOeR3HkXfDg83kfhP0y0yL5JRe1i5geBxqDIJM65nTNFkX6I4MptiP8mkNj1lY1Oqp+M= X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW6PR11MB8367 X-OriginatorOrg: intel.com Hi Ben, On 3/26/26 10:25 AM, Ben Horgan wrote: > When using automatic counter assignment it's useful for a user to know > which counters they can expect to be assigned on group creation. > > Document that automatic counter assignment is best effort and how to > discover any assignment failures. > > Suggested-by: Reinette Chatre > Signed-off-by: Ben Horgan > --- > > Hi Reinette, > I've just taken your suggested paragraph with a minor tweak (s/scenario/a > scenario/) and moved it above the examples as I think it makes sense to > keep examples last in each section. > --- > Documentation/filesystems/resctrl.rst | 6 ++++++ > 1 file changed, 6 insertions(+) > > diff --git a/Documentation/filesystems/resctrl.rst b/Documentation/filesystems/resctrl.rst > index ba609f8d4de5..68cada238844 100644 > --- a/Documentation/filesystems/resctrl.rst > +++ b/Documentation/filesystems/resctrl.rst > @@ -472,6 +472,12 @@ with the following files: > "1": > Auto assignment is enabled. > > + Automatic counter assignment is done with best effort. If auto > + assignment is enabled but there are not enough available counters then > + monitor group creation could succeed while one or more events belonging > + to the group may not have a counter assigned. Consult last_cmd_status "not have a counter assigned" -> "not have a counter assigned in all domains"? > + for details during such a scenario. While last_cmd_status would indicate a failure it is best for user space to consult mbm_L3_assignments for the accurate counter assignment state ("the details"). It is starting to sound like the documentation is directing user space to last_cmd_status for state and I would like to avoid this. How about replacing "Consult last_cmd_status ..." sentence with "Consult mbm_L3_assignments for counter assignment states of the new group."? > + > Example:: > > # echo 0 > /sys/fs/resctrl/info/L3_MON/mbm_assign_on_mkdir Reinette