[PATCH 1/2] Documentation: dsa: b53: fix stale tagging-support section
From: Christian Melendez
Date: Tue Sep 22 2026 - 17:15:57 EST
5325/5365 were listed under "Configuration without tagging support".
b53_get_tag_protocol() assigns them DSA_TAG_PROTO_BRCM_LEGACY_FCS
(commit c3cf059a4d41), implemented in net/dsa/tag_brcm.c. Move them to
the tagging-supported section.
539x/531x5, the only chips left in that section, get no special case
in b53_get_tag_protocol() either. The section and its config examples
no longer apply to any b53 switch, so remove them.
Link: https://patch.msgid.link/CAOiHx==_ixY-VNWX=XxqCFoJvE-80i+r2y6SNnxwQe9uZQJL6w@xxxxxxxxxxxxxx
Signed-off-by: Christian Melendez <chrismelnu@xxxxxxxxx>
---
Documentation/networking/dsa/b53.rst | 151 +--------------------------
1 file changed, 3 insertions(+), 148 deletions(-)
diff --git a/Documentation/networking/dsa/b53.rst b/Documentation/networking/dsa/b53.rst
index 1cb3ff648f88..b67864b2d314 100644
--- a/Documentation/networking/dsa/b53.rst
+++ b/Documentation/networking/dsa/b53.rst
@@ -23,9 +23,6 @@ CPU interface, conversely, the CPU network interface should insert a similar
tag for packets entering the CPU port. The tag format is described in
``net/dsa/tag_brcm.c``.
-The configuration of the device depends on whether or not tagging is
-supported.
-
The interface names and example network configuration are used according the
configuration described in the :ref:`dsa-config-showcases`.
@@ -35,149 +32,7 @@ Configuration with tagging support
The tagging based configuration is desired. It is not specific to the b53
DSA driver and will work like all DSA drivers which supports tagging.
-See :ref:`dsa-tagged-configuration`.
-
-Configuration without tagging support
--------------------------------------
-
-Older models (5325, 5365) support a different tag format that is not supported
-yet. 539x and 531x5 require managed mode and some special handling, which is
-also not yet supported. The tagging support is disabled in these cases and the
-switch need a different configuration.
-
-The configuration slightly differ from the :ref:`dsa-vlan-configuration`.
-
-The b53 tags the CPU port in all VLANs, since otherwise any PVID untagged
-VLAN programming would basically change the CPU port's default PVID and make
-it untagged, undesirable.
-
-In difference to the configuration described in :ref:`dsa-vlan-configuration`
-the default VLAN 1 has to be removed from the user interface configuration in
-single port and gateway configuration, while there is no need to add an extra
-VLAN configuration in the bridge showcase.
-
-single port
-~~~~~~~~~~~
-The configuration can only be set up via VLAN tagging and bridge setup.
-By default packages are tagged with vid 1:
-
-.. code-block:: sh
-
- # tag traffic on CPU port
- ip link add link eth0 name eth0.1 type vlan id 1
- ip link add link eth0 name eth0.2 type vlan id 2
- ip link add link eth0 name eth0.3 type vlan id 3
-
- # The conduit interface needs to be brought up before the user ports.
- ip link set eth0 up
- ip link set eth0.1 up
- ip link set eth0.2 up
- ip link set eth0.3 up
-
- # bring up the user interfaces
- ip link set wan up
- ip link set lan1 up
- ip link set lan2 up
-
- # create bridge
- ip link add name br0 type bridge
-
- # activate VLAN filtering
- ip link set dev br0 type bridge vlan_filtering 1
-
- # add ports to bridges
- ip link set dev wan master br0
- ip link set dev lan1 master br0
- ip link set dev lan2 master br0
-
- # tag traffic on ports
- bridge vlan add dev lan1 vid 2 pvid untagged
- bridge vlan del dev lan1 vid 1
- bridge vlan add dev lan2 vid 3 pvid untagged
- bridge vlan del dev lan2 vid 1
-
- # configure the VLANs
- ip addr add 192.0.2.1/30 dev eth0.1
- ip addr add 192.0.2.5/30 dev eth0.2
- ip addr add 192.0.2.9/30 dev eth0.3
-
- # bring up the bridge devices
- ip link set br0 up
-
-
-bridge
-~~~~~~
+Older models (5325, 5365) use a different, legacy tag format, but tagging
+is supported.
-.. code-block:: sh
-
- # tag traffic on CPU port
- ip link add link eth0 name eth0.1 type vlan id 1
-
- # The conduit interface needs to be brought up before the user ports.
- ip link set eth0 up
- ip link set eth0.1 up
-
- # bring up the user interfaces
- ip link set wan up
- ip link set lan1 up
- ip link set lan2 up
-
- # create bridge
- ip link add name br0 type bridge
-
- # activate VLAN filtering
- ip link set dev br0 type bridge vlan_filtering 1
-
- # add ports to bridge
- ip link set dev wan master br0
- ip link set dev lan1 master br0
- ip link set dev lan2 master br0
- ip link set eth0.1 master br0
-
- # configure the bridge
- ip addr add 192.0.2.129/25 dev br0
-
- # bring up the bridge
- ip link set dev br0 up
-
-gateway
-~~~~~~~
-
-.. code-block:: sh
-
- # tag traffic on CPU port
- ip link add link eth0 name eth0.1 type vlan id 1
- ip link add link eth0 name eth0.2 type vlan id 2
-
- # The conduit interface needs to be brought up before the user ports.
- ip link set eth0 up
- ip link set eth0.1 up
- ip link set eth0.2 up
-
- # bring up the user interfaces
- ip link set wan up
- ip link set lan1 up
- ip link set lan2 up
-
- # create bridge
- ip link add name br0 type bridge
-
- # activate VLAN filtering
- ip link set dev br0 type bridge vlan_filtering 1
-
- # add ports to bridges
- ip link set dev wan master br0
- ip link set eth0.1 master br0
- ip link set dev lan1 master br0
- ip link set dev lan2 master br0
-
- # tag traffic on ports
- bridge vlan add dev wan vid 2 pvid untagged
- bridge vlan del dev wan vid 1
-
- # configure the VLANs
- ip addr add 192.0.2.1/30 dev eth0.2
- ip addr add 192.0.2.129/25 dev br0
-
- # bring up the bridge devices
- ip link set br0 up
+See :ref:`dsa-tagged-configuration`.
--
2.34.1