From: Jonathan Corbet <corbet@lwn.net>
To: Cristian Marussi <cristian.marussi@arm.com>,
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, david@kernel.org,
subrahmanya.lingappa@oss.qualcomm.com, leitao@kernel.org,
kas@kernel.org, puranjay@kernel.org, usama.arif@linux.dev,
kernel-team@meta.com, Cristian Marussi <cristian.marussi@arm.com>,
Shuah Khan <skhan@linuxfoundation.org>
Subject: Re: [PATCH v6 21/22] [RFC] Documentation: Add SCMI System Telemetry documentation
Date: Fri, 24 Jul 2026 09:05:53 -0600 [thread overview]
Message-ID: <874iho8m26.fsf@trenco.lwn.net> (raw)
In-Reply-To: <20260724144430.1440170-22-cristian.marussi@arm.com>
Cristian Marussi <cristian.marussi@arm.com> writes:
> Document ARM SCMI Telemetry IOCTLs interface.
>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: Shuah Khan <skhan@linuxfoundation.org>
> Cc: linux-doc@vger.kernel.org
> Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
> ---
> RFC since it still needs more extensive examples
>
> v5 --> v6
> - fixed typos
> ---
> Documentation/userspace-api/index.rst | 1 +
> Documentation/userspace-api/stlm.rst | 143 ++++++++++++++++++++++++++
> 2 files changed, 144 insertions(+)
> create mode 100644 Documentation/userspace-api/stlm.rst
>
> diff --git a/Documentation/userspace-api/index.rst b/Documentation/userspace-api/index.rst
> index a68b1bea57a8..22daa7ebf78e 100644
> --- a/Documentation/userspace-api/index.rst
> +++ b/Documentation/userspace-api/index.rst
> @@ -54,6 +54,7 @@ Devices and I/O
> dcdbas
> vduse
> isapnp
> + stlm
>
> Everything else
> ===============
> diff --git a/Documentation/userspace-api/stlm.rst b/Documentation/userspace-api/stlm.rst
> new file mode 100644
> index 000000000000..e34226b11373
> --- /dev/null
> +++ b/Documentation/userspace-api/stlm.rst
> @@ -0,0 +1,143 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. stlm:
I'm not sure what that last line is meant to be? It *looks* like it's
meant to be the sort of top-of-file label that I've been trying to get
people to stop adding for years...but it lacks the leading underscore,
and so won't work even for that. Remove that line?
Thanks,
jon
next prev parent reply other threads:[~2026-07-24 15:05 UTC|newest]
Thread overview: 24+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-24 14:44 [PATCH v6 00/22] Introduce SCMI Telemetry support Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 01/22] firmware: arm_scmi: Add new SCMIv4.0 error codes definitions Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 02/22] firmware: arm_scmi: Allow registration of unknown-size events/reports Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 03/22] firmware: arm_scmi: Introduce protocol instance notifiers Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 04/22] dt-bindings: firmware: arm,scmi: Add support for telemetry protocol Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 05/22] include: trace: Add Telemetry trace events Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 06/22] firmware: arm_scmi: Add basic Telemetry support Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 07/22] firmware: arm_scmi: Add support to parse SHMTIs areas Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 08/22] firmware: arm_scmi: Add Telemetry configuration operations Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 09/22] firmware: arm_scmi: Add Telemetry DataEvent read capabilities Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 10/22] firmware: arm_scmi: Add support for Telemetry reset Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 11/22] firmware: arm_scmi: Add Telemetry notification support Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 12/22] firmware: arm_scmi: Add support for boot-on Telemetry Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 13/22] firmware: arm_scmi: Add Telemetry generation counter Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 14/22] firmware: arm_scmi: Add common per-protocol debugfs support Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 15/22] firmware: arm_scmi: Add Telemetry debugfs SHMTI dump support Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 16/22] firmware: arm_scmi: Add Telemetry debugfs ABI documentation Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 17/22] firmware: arm_scmi: Expose per-instance identifier Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 18/22] uapi: Add ARM SCMI Telemetry definitions Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 19/22] firmware: arm_scmi: Add System Telemetry driver Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 20/22] docs: ioctl-number: Add SCMI Ioctls Cristian Marussi
2026-07-24 14:44 ` [PATCH v6 21/22] [RFC] Documentation: Add SCMI System Telemetry documentation Cristian Marussi
2026-07-24 15:05 ` Jonathan Corbet [this message]
2026-07-24 14:44 ` [PATCH v6 22/22] [RFC] tools/scmi: Add SCMI Telemetry testing tool Cristian Marussi
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=874iho8m26.fsf@trenco.lwn.net \
--to=corbet@lwn.net \
--cc=arm-scmi@vger.kernel.org \
--cc=brauner@kernel.org \
--cc=cristian.marussi@arm.com \
--cc=d-gole@ti.com \
--cc=david@kernel.org \
--cc=elif.topuz@arm.com \
--cc=etienne.carriere@st.com \
--cc=f.fainelli@gmail.com \
--cc=james.quinlan@broadcom.com \
--cc=jic23@kernel.org \
--cc=kas@kernel.org \
--cc=kernel-team@meta.com \
--cc=leitao@kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-fsdevel@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=lukasz.luba@arm.com \
--cc=michal.simek@amd.com \
--cc=peng.fan@oss.nxp.com \
--cc=philip.radford@arm.com \
--cc=puranjay@kernel.org \
--cc=skhan@linuxfoundation.org \
--cc=souvik.chakravarty@arm.com \
--cc=subrahmanya.lingappa@oss.qualcomm.com \
--cc=sudeep.holla@kernel.org \
--cc=usama.arif@linux.dev \
--cc=vincent.guittot@linaro.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox