linux-kernel - Re: [PATCH] docs: dt: writing-bindings: Document node name ABI and simple-mfd

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

Message-ID: <175572868343.1564032.6590237767039466297.robh@kernel.org>
Date: Wed, 20 Aug 2025 17:24:45 -0500
From: "Rob Herring (Arm)" <robh@...nel.org>
To: Krzysztof Kozlowski <krzysztof.kozlowski@...aro.org>
Cc: Krzysztof Kozlowski <krzk+dt@...nel.org>, devicetree@...r.kernel.org,
	Conor Dooley <conor+dt@...nel.org>, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] docs: dt: writing-bindings: Document node name ABI and
 simple-mfd


On Mon, 18 Aug 2025 15:25:35 +0200, Krzysztof Kozlowski wrote:
> Document established Devicetree bindings maintainers review practice:
> 
> 1. Device node names should not be treated as an ABI, unless for
>    children of a device when documented.
>    There were many patches posted using of_find_node_by_name() or
>    of_node_name_eq() for accessing siblings or completely different
>    nodes.  These cases were introducing undocumented ABI, so they are
>    discouraged.
> 
> 2. 'simple-mfd' means children do not depend on parent device resources.
>    'simple-bus' is so simple, that even 'reg' properties are not
>    applicable.
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@...aro.org>
> ---
>  Documentation/devicetree/bindings/writing-bindings.rst | 9 +++++++++
>  1 file changed, 9 insertions(+)
> 

Applied, thanks!