linux-kernel - Re: [PATCH 1/3] dt-bindings: net: Convert fsl,gianfar-{mdio,tbi} to YAML

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: <20250226133114.GA1771231-robh@kernel.org>
Date: Wed, 26 Feb 2025 07:31:14 -0600
From: Rob Herring <robh@...nel.org>
To: J. Neuschäfer <j.ne@...teo.net>
Cc: Andrew Lunn <andrew+netdev@...n.ch>,
	"David S. Miller" <davem@...emloft.net>,
	Eric Dumazet <edumazet@...gle.com>,
	Jakub Kicinski <kuba@...nel.org>, Paolo Abeni <pabeni@...hat.com>,
	Krzysztof Kozlowski <krzk+dt@...nel.org>,
	Conor Dooley <conor+dt@...nel.org>,
	Claudiu Manoil <claudiu.manoil@....com>, netdev@...r.kernel.org,
	devicetree@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH 1/3] dt-bindings: net: Convert fsl,gianfar-{mdio,tbi} to
 YAML

On Tue, Feb 25, 2025 at 11:12:42AM +0000, J. Neuschäfer wrote:
> On Mon, Feb 24, 2025 at 08:58:19PM +0000, J. Neuschäfer wrote:
> > On Fri, Feb 21, 2025 at 10:36:51AM -0600, Rob Herring wrote:
> > > On Thu, Feb 20, 2025 at 06:29:21PM +0100, J. Neuschäfer wrote:
> > > > Move the information related to the Freescale Gianfar (TSEC) MDIO bus
> > > > and the Ten-Bit Interface (TBI) from fsl-tsec-phy.txt to a new binding
> > > > file in YAML format, fsl,gianfar-mdio.yaml.
> > > > 
> > > > Signed-off-by: J. Neuschäfer <j.ne@...teo.net>
> > > > ---
> > [...]
> > > > +properties:
> > > > +  compatible:
> > > > +    enum:
> > > > +      - fsl,gianfar-tbi
> > > > +      - fsl,gianfar-mdio
> > > > +      - fsl,etsec2-tbi
> > > > +      - fsl,etsec2-mdio
> > > > +      - fsl,ucc-mdio
> > > > +      - gianfar
> > > 
> > > Can you just comment out this to avoid the duplicate issue.
> > > 
> > > Though I think if you write a custom 'select' which looks for 
> > > 'device_type = "mdio"' with gianfar compatible and similar in the other 
> > > binding, then the warning will go away. 
> > 
> > I'm not sure how the 'select' syntax works, is there a reference
> > document I could read?
> 
> Ok, I think I figured it out, this seems to work as intended:
> 

Looks pretty good.

> 
> select:
>   oneOf:
>     - properties:
>         compatible:

Add "contains" here. That way if someone puts another string in with 
these we still match and then throw a warning.

>           enum:
>             - fsl,gianfar-tbi
>             - fsl,gianfar-mdio
>             - fsl,etsec2-tbi
>             - fsl,etsec2-mdio
>             - fsl,ucc-mdio
> 
>       required:
>         - compatible
> 
>     - properties:
>         compatible:
>           enum:
>             - gianfar
>             - ucc_geth_phy

You could move ucc_geth_phy because there's not a collision with it.

Add a comment somewhere that this is all because of a reuse of gianfar.

>         device_type:
>           const: mdio
> 
>       required:
>         - compatible
>         - device_type

You can move 'required: [compatible]' out of the oneOf.

> 
> properties:
>   compatible:
>     enum:
>       - fsl,gianfar-tbi
>       - fsl,gianfar-mdio
>       - fsl,etsec2-tbi
>       - fsl,etsec2-mdio
>       - fsl,ucc-mdio
>       - gianfar
>       - ucc_geth_phy
> 
>   reg:
>     ...
> 
> 
> 
> Best regards,
> J. Neuschäfer