From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 349FECD98CF for ; Fri, 12 Jun 2026 22:40:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc: To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=rKEg7Igx66frAl7/LUEP7FModaJb5ijqvNNE5ni8Lvg=; b=W/pWzlNr4gef74m1CkVMOhhGAz IAJFEj5MrKRGkAeMSHKkQ4yMDKXqNyvbrUtfvlMopABSuufpJM3IoUqaDfHB9MCcQlf7SZCxwnRMT TP5pfkdjqV8Fq2ElBTAlUMCZOYaE0lH5JRMoUNN7FqH85w3rCg4oM6Xxm3cHF+8g00F40YmLzSOVd MYAOqhWuXygI0bkX2glLRZkejQgomOXeQCb5fwUpi5mrvjFlwSHCLX4kqz5bdXzPombRjAjj8s/Gr BkgVV+Atd3kA6a1XjaWS8KfrA/FuIIflJ2FxtpjjwtH8CLtFg3jK3clnSMM34I7xOyWulBIDfWTbZ 0HQDlUYw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1wYAYH-0000000BhcZ-2lvN; Fri, 12 Jun 2026 22:40:37 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1wYAY5-0000000BhNH-4ACu for linux-arm-kernel@lists.infradead.org; Fri, 12 Jun 2026 22:40:36 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 97CF93543; Fri, 12 Jun 2026 15:40:20 -0700 (PDT) Received: from pluto.fritz.box (usa-sjc-mx-foss1.foss.arm.com [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 5A4113FB7F; Fri, 12 Jun 2026 15:40:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=arm.com; s=foss; t=1781304025; bh=LqAFIQOzWsZZ1f4YVWDCPJKEayziLPMgzmXHTS+j+d8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fkDoszFJVKpPXpqXNuYv5hHk5klDSDyF56xK0IYU8HwlApf3usktjn7YO46T6RwRl uVE8wC8Z5HxlDSmUX+BFsHY+DjAJcCrFTnBPOKOS7p2Mv7HRiroSEPe0JMnxMGScx1 9iDTvps/llxzysFrrMJEzC07b/5noKIurxvSaLxs= From: Cristian Marussi To: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, arm-scmi@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-doc@vger.kernel.org Cc: sudeep.holla@kernel.org, james.quinlan@broadcom.com, f.fainelli@gmail.com, vincent.guittot@linaro.org, etienne.carriere@st.com, peng.fan@oss.nxp.com, michal.simek@amd.com, d-gole@ti.com, jic23@kernel.org, elif.topuz@arm.com, lukasz.luba@arm.com, philip.radford@arm.com, brauner@kernel.org, souvik.chakravarty@arm.com, leitao@kernel.org, kas@kernel.org, puranjay@kernel.org, usama.arif@linux.dev, kernel-team@meta.com, Cristian Marussi Subject: [PATCH v4 26/31] fs/stlmfs: Document alternative topological view Date: Fri, 12 Jun 2026 23:37:56 +0100 Message-ID: <20260612223802.1337232-27-cristian.marussi@arm.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: <20260612223802.1337232-1-cristian.marussi@arm.com> References: <20260612223802.1337232-1-cristian.marussi@arm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.9.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20260612_154026_178903_BAC6C1A1 X-CRM114-Status: UNSURE ( 7.89 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org The human readable interface presents an alternative view based on the discovered topological relations between the DEs. Signed-off-by: Cristian Marussi --- v3 --> v4 - renamed to by-components v2 --> v3 - completed FS tree description - renamed components to by_components --- Documentation/filesystems/stlmfs.rst | 72 ++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) diff --git a/Documentation/filesystems/stlmfs.rst b/Documentation/filesystems/stlmfs.rst index 0c7b7c006709..b5b3cd649775 100644 --- a/Documentation/filesystems/stlmfs.rst +++ b/Documentation/filesystems/stlmfs.rst @@ -143,6 +143,7 @@ create the following directory structure:: |-- all_des_enable |-- all_des_tstamp_enable |-- available_update_intervals_ms + |-- by-components/ |-- control |-- current_update_interval_ms |-- de_implementation_version @@ -233,6 +234,77 @@ values, as in:: |-- intervals_discrete `-- tstamp_enable +by-components/ +----------- + +An alternative topological view of the des/ directory based on the topology +relationship information described in des/ :: + + by-components/ + ├── cpu + │   ├── 0 + │   │   ├── celsius + │   │   │   └── 0 + │   │   │   └── 0x00000001[pe_0] -> ../../../../../des/0x00000001 + │   │   └── cycles + │   │   ├── 0 + │   │   │   └── 0x00001010[] -> ../../../../../des/0x00001010 + │   │   └── 1 + │   │   └── 0x00002020[] -> ../../../../../des/0x00002020 + │   ├── 1 + │   │   └── celsius + │   │   └── 0 + │   │   └── 0x00000002[pe_1] -> ../../../../../des/0x00000002 + │   └── 2 + │   └── celsius + │   └── 0 + │   └── 0x00000003[pe_2] -> ../../../../../des/0x00000003 + ├── interconnnect + │   └── 0 + │   └── hertz + │   └── 0 + │   ├── 0x0000A008[A008_de] -> ../../../../../des/0x0000A008 + │   └── 0x0000A00B[] -> ../../../../../des/0x0000A00B + ├── mem_cntrl + │   └── 0 + │   ├── bps + │   │   └── 0 + │   │   └── 0x0000A00A[] -> ../../../../../des/0x0000A00A + │   ├── celsius + │   │   └── 0 + │   │   └── 0x0000A007[DRAM_temp] -> ../../../../../des/0x0000A007 + │   └── joules + │   └── 0 + │   └── 0x0000A002[DRAM_energy] -> ../../../../../des/0x0000A002 + ├── periph + │   ├── 0 + │   │   └── messages + │   │   └── 0 + │   │   └── 0x00000016[device_16] -> ../../../../../des/0x00000016 + │   ├── 1 + │   │   └── messages + │   │   └── 0 + │   │   └── 0x00000017[device_17] -> ../../../../../des/0x00000017 + │   └── 2 + │   └── messages + │   └── 0 + │   └── 0x00000018[device_18] -> ../../../../../des/0x00000018 + └── unspec + └── 0 + ├── celsius + │ └── 0 + │   └── 0x0000A005[] -> ../../../../../des/0x0000A005 + ├── counts + │   └── 0 + │   └── 0x0000A00C[] -> ../../../../../des/0x0000A00C + ├── joules + │   └── 0 + │   ├── 0x0000A000[SOC_Energy] -> ../../../../../des/0x0000A000 + │   └── 0x0000A001[] -> ../../../../../des/0x0000A001 + └── state + └── 0 + └── 0x0000A010[] -> ../../../../../des/0x0000A010 + Alternative Binary Interfaces - Special files ============================================= -- 2.54.0