lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <20260114114638.2290765-14-cristian.marussi@arm.com>
Date: Wed, 14 Jan 2026 11:46:17 +0000
From: Cristian Marussi <cristian.marussi@....com>
To: linux-kernel@...r.kernel.org,
	linux-arm-kernel@...ts.infradead.org,
	arm-scmi@...r.kernel.org,
	linux-fsdevel@...r.kernel.org
Cc: sudeep.holla@....com,
	james.quinlan@...adcom.com,
	f.fainelli@...il.com,
	vincent.guittot@...aro.org,
	etienne.carriere@...com,
	peng.fan@....nxp.com,
	michal.simek@....com,
	dan.carpenter@...aro.org,
	d-gole@...com,
	jonathan.cameron@...wei.com,
	elif.topuz@....com,
	lukasz.luba@....com,
	philip.radford@....com,
	souvik.chakravarty@....com,
	Cristian Marussi <cristian.marussi@....com>
Subject: [PATCH v2 13/17] fs/stlmfs: Document alternative topological view

The human readable interface presents an alternative view based on the
discovered topological relations between the DEs.

Signed-off-by: Cristian Marussi <cristian.marussi@....com>
---
 Documentation/filesystems/stlmfs.rst | 72 ++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)

diff --git a/Documentation/filesystems/stlmfs.rst b/Documentation/filesystems/stlmfs.rst
index 5c23f7e5f12c..cc9585f77ba5 100644
--- a/Documentation/filesystems/stlmfs.rst
+++ b/Documentation/filesystems/stlmfs.rst
@@ -112,6 +112,7 @@ the following directory structure::
 	|-- all_des_enable
 	|-- all_des_tstamp_enable
 	|-- available_update_intervals_ms
+	|-- components/
 	|-- control
 	|-- current_update_interval_ms
 	|-- de_implementation_version
@@ -202,6 +203,77 @@ values, as in::
 	|-- intervals_discrete
 	`-- tstamp_enable
 
+components/
+-----------
+
+An alternative topological view of the des/ directory based on the topology
+relationship information described in des/ ::
+
+	components/
+	├── cpu
+	│   ├── 0
+	│   │   ├── celsius
+	│   │   │   └── 0
+	│   │   │       └── 0x00000001 -> ../../../../../des/0x00000001
+	│   │   └── cycles
+	│   │       ├── 0
+	│   │       │   └── 0x00001010 -> ../../../../../des/0x00001010
+	│   │       └── 1
+	│   │           └── 0x00002020 -> ../../../../../des/0x00002020
+	│   ├── 1
+	│   │   └── celsius
+	│   │       └── 0
+	│   │           └── 0x00000002 -> ../../../../../des/0x00000002
+	│   └── 2
+	│       └── celsius
+	│           └── 0
+	│               └── 0x00000003 -> ../../../../../des/0x00000003
+	├── interconnnect
+	│   └── 0
+	│       └── hertz
+	│           └── 0
+	│               ├── 0x0000A008 -> ../../../../../des/0x0000A008
+	│               └── 0x0000A00B -> ../../../../../des/0x0000A00B
+	├── mem_cntrl
+	│   └── 0
+	│       ├── bps
+	│       │   └── 0
+	│       │       └── 0x0000A00A -> ../../../../../des/0x0000A00A
+	│       ├── celsius
+	│       │   └── 0
+	│       │       └── 0x0000A007 -> ../../../../../des/0x0000A007
+	│       └── joules
+	│           └── 0
+	│               └── 0x0000A002 -> ../../../../../des/0x0000A002
+	├── periph
+	│   ├── 0
+	│   │   └── messages
+	│   │       └── 0
+	│   │           └── 0x00000016 -> ../../../../../des/0x00000016
+	│   ├── 1
+	│   │  	└── messages
+	│   │       └── 0
+	│   │           └── 0x00000017 -> ../../../../../des/0x00000017
+	│   └── 2
+	│       └── messages
+	│           └── 0
+	│               └── 0x00000018 -> ../../../../../des/0x00000018
+	└── unspec
+	└── 0
+	├── celsius
+	│   └── 0
+	│       └── 0x0000A005 -> ../../../../../des/0x0000A005
+	├── counts
+	│   └── 0
+	│       └── 0x0000A00C -> ../../../../../des/0x0000A00C
+	├── joules
+	│   └── 0
+	│      	├── 0x0000A000 -> ../../../../../des/0x0000A000
+	│       └── 0x0000A001 -> ../../../../../des/0x0000A001
+	└── state
+	└── 0
+	└── 0x0000A010 -> ../../../../../des/0x0000A010
+
 Alternative Binary Interfaces - Special files
 =============================================
 
-- 
2.52.0


Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ