From patchwork Thu Jun 1 19:01:31 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Moger, Babu" X-Patchwork-Id: 102147 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:994d:0:b0:3d9:f83d:47d9 with SMTP id k13csp560527vqr; Thu, 1 Jun 2023 12:20:34 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ6nzuZ/Ovm0M4qXZ2X5l6eSrGGFD2zMADchTzFQt6WOeJhEYPGK0bdKKWV1mCsm98FogqUh X-Received: by 2002:a17:90a:d702:b0:24e:3b69:a87f with SMTP id y2-20020a17090ad70200b0024e3b69a87fmr290353pju.25.1685647234412; Thu, 01 Jun 2023 12:20:34 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1685647234; cv=pass; d=google.com; s=arc-20160816; b=oljagMr9NDdyoYK8jLONT/+q9qiPwpxqx/pxOxGA36PuCHO5fZ5hTv5mtHlY4Vr9dO TwEtHsqZ6iDVXMP8KMhquxpjbonyXYW6AGBkxKq3L4c2hqlCb5uZ7h89IJL58bVgHJ2B 8Odd1eUIe3N8yT1gB7/UVOo++VLsBhCnP/rE1oB/vaec8FkuyY+jvzh61eFwoa0ktXOk whtfkmKtJc1H1+pTJKfQCCANRZerjM4mh4w/hf6j2L+EVTvviNMyFdgUyPpXOfaWhR/Y 57Xsbg0GyfU6ktC06aF5qTvUtsWyWYUgShqV1e1ipoEJHK1u+o625q86HF+R8kQZpaGv uRwQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :user-agent:references:in-reply-to:message-id:date:cc:to:from :subject:dkim-signature; bh=qoVa02dLFHualE+BoKCmgPQ9TgNP0FupFOQWvV33T20=; b=B/Ji/E1atajzid6v1zmDGLnmb05WWHRQGn6zLPLV2lUtize6Ok3PBAwZMM9QUFI72J FSC+J6jF37h/dqFD8B7njuz6p8cmOcKDnQj7nEwO/9PA7UwtvfJvnl8sHq/oQSDNuB/B 8kK+SfihJmOTcy7e9PCfbhbO1Qkt1FH2BGjSGox7pozAW7luf1dNlN6ZWbQuagqUpWK5 VPCPoZMH81KnCHdaGGbPvCbz6zhUPSOD3vGuUnnJtxDIowQVkCT1q3sCNtINJ6ln7cHW uaIZFjVjT3n0a8hgaN/3BMg6D1SL7H57yEm6TAb5Pw0eApIq1oyP0nEPsaRUeCK+mUN2 Rc6w== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=qCoOP3FI; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id rm10-20020a17090b3eca00b002508889985fsi1577922pjb.95.2023.06.01.12.20.21; Thu, 01 Jun 2023 12:20:34 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=qCoOP3FI; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232579AbjFATB4 (ORCPT + 99 others); Thu, 1 Jun 2023 15:01:56 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51034 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231994AbjFATBv (ORCPT ); Thu, 1 Jun 2023 15:01:51 -0400 Received: from NAM04-BN8-obe.outbound.protection.outlook.com (mail-bn8nam04on2062.outbound.protection.outlook.com [40.107.100.62]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9D774E48; Thu, 1 Jun 2023 12:01:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ehUxeGvyoQXvp66xMnH1dCyap0VKIDzwaCCjVe/M6W0fzwBSVVMvgEYvEW3D1m4dbJDhplfWiXBNUdHv4ITSgNOEUMEe865tBiSv1U25n5LblecW5u0/woHhgWhx5uJbrevh/hDKdi/F3cD5X/oYeuQHX9x4n7/aSesHjGpE7Z8wCstWD67Grtsl0VqlI5PldIcWF5t6nBwophiVnxDKVeFQ/gogrt3tnsX+l1xv7VCP67Yw/cyd4GN3CDvmgm8TNrPZtYXX83aAPVP/xXqlSmMr8AFhh80Lhhzt/2zBL5WSyCU8HcFVakIfw87r6UhqmSjgDRGaJ5ih5xdiIReTxA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=qoVa02dLFHualE+BoKCmgPQ9TgNP0FupFOQWvV33T20=; b=D25libUkwKM2E+oxP3SwXRsB9MS5l7gYzQWkOO94q8xP1GmjrdCwKv0OAEekbB5lyffvQGkhn1fiEu8snI9mIecQKtop+gcZTNPmz9qSQzlZZocyCbgqyCIJietcZI7CkKQKZvcQ0mIESSfwPeoTWZhwCwxobZtJoNfp8iYv3WBZO3iOFi5HHs6ED8WHgH6SX2mVWQTN/CBhQw7SGGRpKSX2e5WJJQuNrkYorqVDtVJnW47bBshQpLsHR6iZei2PAHiASUZ3M62UC7i+ddvnM2k+QF9e61iu0rRIHXVdiahmvURk34YStym+353Lc8nzIgXr8JJKdi4b51Axof4jlg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=intel.com smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=qoVa02dLFHualE+BoKCmgPQ9TgNP0FupFOQWvV33T20=; b=qCoOP3FI0bKZj5Dr4P84pFbdWLwyl5FeR8mooCKXNyR8u7ByU7vDYPFOXf+cdoh7Ly4/nGaqdYUBVfCjI8/9WGw4q3Oeu25smRA+k5UJs5bSpWrFoerhAGA3ktpmMmONQj6fNKjxcqRL3uDbUYHj0XZQbcWwRtlutlBMo3WE7Kg= Received: from BN9PR03CA0674.namprd03.prod.outlook.com (2603:10b6:408:10e::19) by IA1PR12MB6235.namprd12.prod.outlook.com (2603:10b6:208:3e5::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.23; Thu, 1 Jun 2023 19:01:36 +0000 Received: from BN8NAM11FT081.eop-nam11.prod.protection.outlook.com (2603:10b6:408:10e:cafe::68) by BN9PR03CA0674.outlook.office365.com (2603:10b6:408:10e::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.23 via Frontend Transport; Thu, 1 Jun 2023 19:01:36 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C Received: from SATLEXMB04.amd.com (165.204.84.17) by BN8NAM11FT081.mail.protection.outlook.com (10.13.177.233) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6455.24 via Frontend Transport; Thu, 1 Jun 2023 19:01:36 +0000 Received: from [127.0.1.1] (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Thu, 1 Jun 2023 14:01:33 -0500 Subject: [PATCH v5 4/8] x86/resctrl: Add comments on RFTYPE flags hierarchy From: Babu Moger To: , , , , CC: , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , Date: Thu, 1 Jun 2023 14:01:31 -0500 Message-ID: <168564609148.527584.17320328540832247657.stgit@bmoger-ubuntu> In-Reply-To: <168564586603.527584.10518315376465080920.stgit@bmoger-ubuntu> References: <168564586603.527584.10518315376465080920.stgit@bmoger-ubuntu> User-Agent: StGit/1.1.dev103+g5369f4c MIME-Version: 1.0 X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB04.amd.com (10.181.40.145) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT081:EE_|IA1PR12MB6235:EE_ X-MS-Office365-Filtering-Correlation-Id: 9eaaa9a9-b9b5-4f65-b0ce-08db62d29f7c X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: zJ2WtJ7bvgw/5qWAXxu/XOMx5+bWeMQmIvSj59pr+W9G7crDcztDsddaVSyAYjtKbixHAXHVL9RwlCcpsDPcNST/TdatgFbn/IvWQkTn7u3h6UDwuUwrz3EENZCYoJtwd9Uev/oV4gcw9uJQnf5gavikl3wGnn9dh3bYtf89nh/wPgZCu5UOJDpayt1yBf57QVFpzOlRmwgLdbFPTW9HgU8+gsd9EEUAFvpBOsMumGZ7G4AyJcFmouxupR0T8uHyM5HbzR5Yq+gmgZH2BwnYzaozLgKWPE250Ykao/yKZudAQP5Vo2AMomZEGHxMhVVqQW4mgoizzjd7A/pzWYe7JOPRwSvkZiUCL6UZj9cZalg1FZR8Ve4hTVMB1h0ES6R0hxK8WqZvCF+pnCDdlsxWcn73tPFIQc8RfYv3Nn0AgOodahIpPmCllv+1VL3GSCAyqjsmJ61NRmFwSDvDK6AKy2zNKTcSzrcLSmzK3mSmMfmWguOw++rZzTnG74jjVrVVWypXHKQjqFZbR2mCnzCSDGahwX7e0JP6xX6aeRpHJyP8XlQMXNL77oOxObnrWw+qUAmW/fmKwk5ZJdfqXxOTn0PXDkovrGh4f+LzCVGo703a/xMLCRYxVPUGdt2TDachWF/Buw9mP+AjCw3D3COOjUB619mTX//YVmUfhI6Z+a7VI+8EvFhKnoIUmNtQY82UYHlFX8YqOcu81tZx6jGZFdsROOqKRZUhpdZAiWL09HIKNOyHEFJainAdH5AeFU81hxDgBY/YADHzkHumNF5mZCnGtUre8Zimy3MzyoHxh8s= X-Forefront-Antispam-Report: CIP:165.204.84.17;CTRY:US;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:SATLEXMB04.amd.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230028)(4636009)(7916004)(136003)(39860400002)(346002)(376002)(396003)(451199021)(46966006)(36840700001)(40470700004)(103116003)(33716001)(478600001)(47076005)(40480700001)(9686003)(26005)(186003)(16526019)(426003)(336012)(36860700001)(40460700003)(41300700001)(4326008)(356005)(81166007)(70586007)(70206006)(82740400003)(316002)(82310400005)(44832011)(7416002)(7406005)(86362001)(2906002)(5660300002)(8936002)(8676002)(16576012)(54906003)(110136005)(71626016)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Jun 2023 19:01:36.0679 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 9eaaa9a9-b9b5-4f65-b0ce-08db62d29f7c X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT081.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR12MB6235 X-Spam-Status: No, score=-1.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FORGED_SPF_HELO, RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_NONE, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1767529234208019804?= X-GMAIL-MSGID: =?utf-8?q?1767529234208019804?= resctrl uses RFTYPE flags for creating resctrl directory structure. Definitions and directory structures are not documented. Add comments to improve the readability and help future additions. Signed-off-by: Babu Moger --- arch/x86/kernel/cpu/resctrl/internal.h | 45 ++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/arch/x86/kernel/cpu/resctrl/internal.h b/arch/x86/kernel/cpu/resctrl/internal.h index 2051179a3b91..c20cd6acb7a3 100644 --- a/arch/x86/kernel/cpu/resctrl/internal.h +++ b/arch/x86/kernel/cpu/resctrl/internal.h @@ -240,6 +240,51 @@ struct rdtgroup { /* * Define the file type flags for base and info directories. + * + * RESCTRL filesystem has two main components + * a. info + * b. base + * + * /sys/fs/resctrl/ + * | + * --> info (directory and provides details on control + * | and monitoring resources) + * | + * --> base (Lists the files and information to interact with control + * or monitor groups. Provides details on default control + * group when filesystem is created. There is no directory + * with name base) + * + * info structure + * ------------------------------------------------------------- + * --> RFTYPE_INFO + * --> directory + * --> RFTYPE_TOP_INFO + * Files: last_cmd_status + * + * --> RFTYPE_MON_INFO + * --> directory + * Files: max_threshold_occupancy, mbm_local_bytes_config, + * mbm_total_bytes_config, mon_features, num_rmids + * + * --> RFTYPE_CTRL_INFO + * --> RFTYPE_RES_CACHE + * --> directory + * Files: bit_usage, cbm_mask, min_cbm_bits, + * num_closids, shareable_bits + * + * --> RFTYPE_RES_MB + * --> directory + * Files: bandwidth_gran, delay_linear, min_bandwidth, + * num_closids + * + * base structure + * ----------------------------------------------------------- + * --> RFTYPE_BASE (Files common for both MON and CTRL groups) + * Files: cpus, cpus_list, tasks + * + * --> RFTYPE_CTRL_BASE (Files only for CTRL group) + * Files: mode, schemata, size */ #define RFTYPE_INFO BIT(0) #define RFTYPE_BASE BIT(1)