linux-kernel - Re: [PATCH net-next v5 1/9] dt-bindings: net: Expand pcs-handle to an array

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: <44db6758-2f81-0374-809f-9db0cf2f2e33@seco.com>
Date:   Tue, 27 Sep 2022 12:27:35 -0400
From:   Sean Anderson <sean.anderson@...o.com>
To:     Rob Herring <robh@...nel.org>
Cc:     "David S . Miller" <davem@...emloft.net>,
        Jakub Kicinski <kuba@...nel.org>,
        Madalin Bucur <madalin.bucur@....com>,
        Camelia Alexandra Groza <camelia.groza@....com>,
        netdev@...r.kernel.org, Eric Dumazet <edumazet@...gle.com>,
        Paolo Abeni <pabeni@...hat.com>,
        linux-arm-kernel@...ts.infradead.org, linux-kernel@...r.kernel.org,
        Russell King <linux@...linux.org.uk>,
        "linuxppc-dev @ lists . ozlabs . org" <linuxppc-dev@...ts.ozlabs.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@...aro.org>,
        devicetree@...r.kernel.org
Subject: Re: [PATCH net-next v5 1/9] dt-bindings: net: Expand pcs-handle to an
 array



On 9/27/22 11:33 AM, Rob Herring wrote:
> On Mon, Sep 26, 2022 at 03:03:13PM -0400, Sean Anderson wrote:
>> This allows multiple phandles to be specified for pcs-handle, such as
>> when multiple PCSs are present for a single MAC. To differentiate
>> between them, also add a pcs-handle-names property.
>> 
>> Signed-off-by: Sean Anderson <sean.anderson@...o.com>
>> ---
>> This was previously submitted as [1]. I expect to update this series
>> more, so I have moved it here. Changes from that version include:
>> - Add maxItems to existing bindings
>> - Add a dependency from pcs-names to pcs-handle.
>> 
>> [1] https://lore.kernel.org/netdev/20220711160519.741990-3-sean.anderson@seco.com/
>> 
>> (no changes since v4)
>> 
>> Changes in v4:
>> - Use pcs-handle-names instead of pcs-names, as discussed
>> 
>> Changes in v3:
>> - New
>> 
>>  .../bindings/net/dsa/renesas,rzn1-a5psw.yaml           |  1 +
>>  .../devicetree/bindings/net/ethernet-controller.yaml   | 10 +++++++++-
>>  .../devicetree/bindings/net/fsl,qoriq-mc-dpmac.yaml    |  2 +-
>>  3 files changed, 11 insertions(+), 2 deletions(-)
>> 
>> diff --git a/Documentation/devicetree/bindings/net/dsa/renesas,rzn1-a5psw.yaml b/Documentation/devicetree/bindings/net/dsa/renesas,rzn1-a5psw.yaml
>> index 7ca9c19a157c..a53552ee1d0e 100644
>> --- a/Documentation/devicetree/bindings/net/dsa/renesas,rzn1-a5psw.yaml
>> +++ b/Documentation/devicetree/bindings/net/dsa/renesas,rzn1-a5psw.yaml
>> @@ -74,6 +74,7 @@ properties:
>>  
>>          properties:
>>            pcs-handle:
>> +            maxItems: 1
> 
> Forgot to remove the $ref here.
> 
>>              description:
>>                phandle pointing to a PCS sub-node compatible with
>>                renesas,rzn1-miic.yaml#
>> diff --git a/Documentation/devicetree/bindings/net/ethernet-controller.yaml b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
>> index 4b3c590fcebf..5bb2ec2963cf 100644
>> --- a/Documentation/devicetree/bindings/net/ethernet-controller.yaml
>> +++ b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
>> @@ -108,11 +108,16 @@ properties:
>>      $ref: "#/properties/phy-connection-type"
>>  
>>    pcs-handle:
>> -    $ref: /schemas/types.yaml#/definitions/phandle
>> +    $ref: /schemas/types.yaml#/definitions/phandle-array
> 
> 'phandle-array' is really a matrix, so this needs a bit more:
> 
> items:
>   maxItems: 1
> 
> Which basically says this is phandles with no arg cells.
> 
>>      description:
>>        Specifies a reference to a node representing a PCS PHY device on a MDIO
>>        bus to link with an external PHY (phy-handle) if exists.
>>  
>> +  pcs-handle-names:
>> +    $ref: /schemas/types.yaml#/definitions/string-array
> 
> No need for a type as *-names already has a type.
> 
>> +    description:
>> +      The name of each PCS in pcs-handle.
>> +
>>    phy-handle:
>>      $ref: /schemas/types.yaml#/definitions/phandle
>>      description:
>> @@ -216,6 +221,9 @@ properties:
>>          required:
>>            - speed
>>  
>> +dependencies:
>> +  pcs-handle-names: [pcs-handle]
>> +
>>  allOf:
>>    - if:
>>        properties:
>> diff --git a/Documentation/devicetree/bindings/net/fsl,qoriq-mc-dpmac.yaml b/Documentation/devicetree/bindings/net/fsl,qoriq-mc-dpmac.yaml
>> index 7f620a71a972..600240281e8c 100644
>> --- a/Documentation/devicetree/bindings/net/fsl,qoriq-mc-dpmac.yaml
>> +++ b/Documentation/devicetree/bindings/net/fsl,qoriq-mc-dpmac.yaml
>> @@ -31,7 +31,7 @@ properties:
>>    phy-mode: true
>>  
>>    pcs-handle:
>> -    $ref: /schemas/types.yaml#/definitions/phandle
>> +    maxItems: 1
>>      description:
>>        A reference to a node representing a PCS PHY device found on
>>        the internal MDIO bus.
>> -- 
>> 2.35.1.1320.gc452695387.dirty
>> 
>> 
> 

OK, I've added these changes for v6.

--Sean