linux-kernel - [PATCH] firmware: arm_scmi: Clarify Raw per-channel ABI documentation

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-next>] [day] [month] [year] [list]

Message-Id: <20230120122326.1932614-1-cristian.marussi@arm.com>
Date:   Fri, 20 Jan 2023 12:23:26 +0000
From:   Cristian Marussi <cristian.marussi@....com>
To:     linux-kernel@...r.kernel.org, linux-arm-kernel@...ts.infradead.org
Cc:     sudeep.holla@....com, Cristian Marussi <cristian.marussi@....com>,
        Vincent Guittot <vincent.guittot@...aro.org>
Subject: [PATCH] firmware: arm_scmi: Clarify Raw per-channel ABI documentation

Explain more in detail how the per-channel <m> identifier is chosen.

Suggested-by: Vincent Guittot <vincent.guittot@...aro.org>
Signed-off-by: Cristian Marussi <cristian.marussi@....com>
---
 Documentation/ABI/testing/debugfs-scmi-raw | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/Documentation/ABI/testing/debugfs-scmi-raw b/Documentation/ABI/testing/debugfs-scmi-raw
index 5468ec08c084..b1c505ed444c 100644
--- a/Documentation/ABI/testing/debugfs-scmi-raw
+++ b/Documentation/ABI/testing/debugfs-scmi-raw
@@ -80,9 +80,13 @@ Description:	SCMI Raw synchronous message injection/snooping facility; write
 		Each write to the entry causes one command request to be built
 		and sent while the replies are read back one message at time
 		(receiving an EOF at each message boundary).
+		Channel identifier <m> matches the SCMI protocol number which
+		has been associated with this transport channel in the DT
+		description, with Base protocol number 0x10 being the default
+		channel for this instance.
 		Note that these per-channel entries rooted at <..>/channels
 		exist only if the transport is configured to have more than
-		one channel.
+		one default channel.
 Users:		Debugging, any userspace test suite
 
 What:		/sys/kernel/debug/scmi/<n>/raw/channels/<m>/message_async
@@ -103,7 +107,11 @@ Description:	SCMI Raw asynchronous message injection/snooping facility; write
 		Each write to the entry causes one command request to be built
 		and sent while the replies are read back one message at time
 		(receiving an EOF at each message boundary).
+		Channel identifier <m> matches the SCMI protocol number which
+		has been associated with this transport channel in the DT
+		description, with Base protocol number 0x10 being the default
+		channel for this instance.
 		Note that these per-channel entries rooted at <..>/channels
 		exist only if the transport is configured to have more than
-		one channel.
+		one default channel.
 Users:		Debugging, any userspace test suite
-- 
2.34.1