Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Colin Foster <colin.foster@in-advantage.com>
To:     linux-renesas-soc@vger.kernel.org,
        linux-mediatek@lists.infradead.org,
        linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org,
        devicetree@vger.kernel.org, netdev@vger.kernel.org
Cc:     John Crispin <john@phrozen.org>,
        Alexandre Belloni <alexandre.belloni@bootlin.com>,
        Claudiu Manoil <claudiu.manoil@nxp.com>,
        Marek Vasut <marex@denx.de>,
        Sean Wang <sean.wang@mediatek.com>,
        DENG Qingfang <dqfext@gmail.com>,
        Landen Chao <Landen.Chao@mediatek.com>,
        =?UTF-8?q?n=C3=A7=20=C3=9CNAL?= <arinc.unal@arinc9.com>,
        Vivien Didelot <vivien.didelot@gmail.com>,
        =?UTF-8?q?Cl=C3=A9ment=20L=C3=A9ger?= <clement.leger@bootlin.com>,
        =?UTF-8?q?Alvin=20=C5=A0ipraga?= <alsi@bang-olufsen.dk>,
        Linus Walleij <linus.walleij@linaro.org>,
        UNGLinuxDriver@microchip.com,
        Woojung Huh <woojung.huh@microchip.com>,
        Matthias Brugger <matthias.bgg@gmail.com>,
        Kurt Kanzenbach <kurt@linutronix.de>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Rob Herring <robh+dt@kernel.org>,
        Paolo Abeni <pabeni@redhat.com>,
        Jakub Kicinski <kuba@kernel.org>,
        Eric Dumazet <edumazet@google.com>,
        "David S. Miller" <davem@davemloft.net>,
        Vladimir Oltean <olteanv@gmail.com>,
        Florian Fainelli <f.fainelli@gmail.com>,
        Andrew Lunn <andrew@lunn.ch>,
        George McCollister <george.mccollister@gmail.com>,
        Rob Herring <robh@kernel.org>
Subject: [PATCH v3 net-next 01/10] dt-bindings: net: dsa: sf2: fix brcm,use-bcm-hdr documentation
Date:   Sun, 27 Nov 2022 14:47:25 -0800
Message-Id: <20221127224734.885526-2-colin.foster@in-advantage.com>
In-Reply-To: <20221127224734.885526-1-colin.foster@in-advantage.com>
References: <20221127224734.885526-1-colin.foster@in-advantage.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?EKphD66QngkxR+bX0nSv70AUpQd0CTtpADD5kgZ6JBiqQUzM+LKrI9rFkGv+?=
 =?us-ascii?Q?mgoJ/aXIzy7SE9rlxQ/MJkDBbbpRtM3bfiDB30zYC5KE7Ey29rUgbRMAu0ry?=
 =?us-ascii?Q?R41d9r2pVp74Yy5uZQM2XqoJFZqTgFVumoCWxsDPh9aobzK2VK0maBfGKREw?=
 =?us-ascii?Q?CWmtASm53Emj+HZBQuB59G06tRf2OmZrVrwtyntMHWaDe1lw79cIgbTuaAVL?=
 =?us-ascii?Q?/+1YDIMGOE9KZ8txO8Ee0cgHHG6s2XDcS8hfYKd+AsMLvjkHJJ9O4wvXMIE7?=
 =?us-ascii?Q?Byq9E+/FrbhxHlaXEiGhFylSbm1CBuDWHSYx/FPOObQFfV8kB3jIJF8gcXu1?=
 =?us-ascii?Q?0yTlVBSh7DudEqtJx2EikhwIwRZsulIzwFfDGETJR4eTeKMC0TwKYoV0Ch2s?=
 =?us-ascii?Q?D0S+951P8aucsgLw6/isLoi817hovdzY7VGRIHWU8SGL3k7OFoyCWb6lujOg?=
 =?us-ascii?Q?cmVij+pJkW7KQ6UddWHo7tZjHBYcGC0sNvBaQR8iLVMbe0itCwyOO8vFZF9v?=
 =?us-ascii?Q?bCChlyCYdDuvYjdhROca2BFFqv8wjkumhe0gT5WhkqOtwdxAW0ASuJYaGaHE?=
 =?us-ascii?Q?QyPrnt+gexENXT4GhZmIuF9/F5Xf9jftC0sAfAj4XHmQQ1gFtQsd213pHWlr?=
 =?us-ascii?Q?ijMiVWaRNARayVG/CG1H4K1hq+/UP0rnE34X/wximsOFTh/38+c/XfzkoYhl?=
 =?us-ascii?Q?viH99SEjqNpwI7mxGHF//wNzEv/vlXkvjOjqOKq/Elr/bXbeQKVx3e4xaB8F?=
 =?us-ascii?Q?6M5tM7AzfP0SE1cZOh+MIe3cetAkncan5EMzMa9kLMOGdNuZkfYOz8Q3uqBZ?=
 =?us-ascii?Q?Ca58VVlEwUSYXHMmKyqvqiJzQhSc/5E/FV4SoAHpn1Z3AYCfQcyvKfzlV4X2?=
 =?us-ascii?Q?UV2DZB14Fkb+o4cjYQkbU4mJQBGbtVYxdlonBsyHNB6weisWBslpkV6HPadY?=
 =?us-ascii?Q?9Pyen3gKmloCdLIf6c7EEbS7f+PecMQbnSNz6uffzMfdVl2blwWjkgS7ks7J?=
 =?us-ascii?Q?CVgzmQUbjZRzjz174xmSMiSoj66ecTI7fgnF7C0A+Nb3bUvHYWAcbjIoSEsD?=
 =?us-ascii?Q?rBY0hHNkobZb58kd4vQ2Xz+MCMTxn8ZjP+YodguGVyALaWg8hbDEuh8eeDfj?=
 =?us-ascii?Q?TvlMlSYHzw6CDb90lAuPWLe2ksQvlq9YWXyJIzDymoLDem7Zmw6LPUBpx/gK?=
 =?us-ascii?Q?ri/fITyP2fHf1q7LXwMaIsexr9NVTLq0ouPCyBXddJCZUuUr0NFLDiA5Lstq?=
 =?us-ascii?Q?F6PHkfxOOEF3Cxw51KfCh79L/3+vaaRkosOAIT+oG6MMbIEF10ijlBQTfhEj?=
 =?us-ascii?Q?/mS+Zy+KoTgX/0z7tG7Enhz60liIxnxzBsTXxJ6W2s3VUQH9sENXefmIblk/?=
 =?us-ascii?Q?gFkjE9GVvGxsEiOJougbbE2InyfJpLqSo7zOLaptjCRA2SQXtCaR6VmUWlIn?=
 =?us-ascii?Q?5siFdffLv/MGWw9I7gFIdZZmyAEVcEzmftw82L91GK11syYQP6ccC4fPS/Se?=
 =?us-ascii?Q?HRKzSa4DETOsfR/SejpxlTpGhMnZH2qLZuYhHeW/vmqUwfoGIPSBYfodLJJb?=
 =?us-ascii?Q?TtU+5gt6vauRVyyFWnYZ3lbkP977oaSWppNRnlkxWyXZYRGx6+Fr55nJ2nkd?=
 =?us-ascii?Q?qA=3D=3D?=
X-OriginatorOrg: in-advantage.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 14587bb9-4a40-4e5d-9929-08dad0c96833
X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2351.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Nov 2022 22:47:48.4374
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 48e842ca-fbd8-4633-a79d-0c955a7d3aae
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: 3WKf3H781wnNx0dQf2WPtnLf3//UCezk0akZtJ3EyYsyd2QwNL9MySXn9vRaPGwD4FogDyS5TNUDJc7qSjOYfVqnOlt1+Eya1/cI8GD13/Q=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN0PR10MB4998
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

The property use-bcm-hdr was documented as an entry under the ports node
for the bcm_sf2 DSA switch. This property is actually evaluated for each
port. Correct the documentation to match the actual behavior and properly
reference dsa-port.yaml for additional properties of the node.

Suggested-by: Rob Herring <robh@kernel.org>
Signed-off-by: Colin Foster <colin.foster@in-advantage.com>
---

v3
  * New patch

---
 .../devicetree/bindings/net/dsa/brcm,sf2.yaml     | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/Documentation/devicetree/bindings/net/dsa/brcm,sf2.yaml b/Documentation/devicetree/bindings/net/dsa/brcm,sf2.yaml
index d159ac78cec1..eed16e216fb6 100644
--- a/Documentation/devicetree/bindings/net/dsa/brcm,sf2.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/brcm,sf2.yaml
@@ -85,11 +85,16 @@ properties:
   ports:
     type: object
 
-    properties:
-      brcm,use-bcm-hdr:
-        description: if present, indicates that the switch port has Broadcom
-          tags enabled (per-packet metadata)
-        type: boolean
+    patternProperties:
+      '^port@[0-9a-f]$':
+        $ref: dsa-port.yaml#
+        unevaluatedProperties: false
+
+        properties:
+          brcm,use-bcm-hdr:
+            description: if present, indicates that the switch port has Broadcom
+              tags enabled (per-packet metadata)
+            type: boolean
 
 required:
   - reg
-- 
2.25.1