Commit ae0b829d authored by Jakub Kicinski's avatar Jakub Kicinski Committed by David S. Miller
Browse files

docs: networkng: convert sja1105's devlink info to RTS 



A new file snuck into the tree after all existing documentation
was converted to RST. Convert sja1105's devlink info and move
it where the rest of the drivers are documented.

Signed-off-by: default avatarJakub Kicinski <kuba@kernel.org>
Acked-by: default avatarVladimir Oltean <vladimir.oltean@nxp.com>
Tested-by: default avatarVladimir Oltean <vladimir.oltean@nxp.com>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent b548493c

Documentation/networking/devlink-params-sja1105.txt

deleted100644 → 0
+0 −27
Original line number Diff line number Diff line 
best_effort_vlan_filtering

			[DEVICE, DRIVER-SPECIFIC]

			Allow plain ETH_P_8021Q headers to be used as DSA tags.

			Benefits:

			- Can terminate untagged traffic over switch net

			  devices even when enslaved to a bridge with

			  vlan_filtering=1.

			- Can terminate VLAN-tagged traffic over switch net

			  devices even when enslaved to a bridge with

			  vlan_filtering=1, with some constraints (no more than

			  7 non-pvid VLANs per user port).

			- Can do QoS based on VLAN PCP and VLAN membership

			  admission control for autonomously forwarded frames

			  (regardless of whether they can be terminated on the

			  CPU or not).

			Drawbacks:

			- User cannot use VLANs in range 1024-3071. If the

			  switch receives frames with such VIDs, it will

			  misinterpret them as DSA tags.

			- Switch uses Shared VLAN Learning (FDB lookup uses

			  only DMAC as key).

			- When VLANs span cross-chip topologies, the total

			  number of permitted VLANs may be less than 7 per

			  port, due to a maximum number of 32 VLAN retagging

			  rules per switch.

			Configuration mode: runtime

			Type: bool.

Documentation/networking/devlink/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -40,5 +40,6 @@ parameters, info versions, and other features it supports. 
   mv88e6xxx

   netdevsim

   nfp

   sja1105

   qed

   ti-cpsw-switch

Documentation/networking/devlink/sja1105.rst

0 → 100644
+49 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GPL-2.0



=======================

sja1105 devlink support

=======================



This document describes the devlink features implemented

by the ``sja1105`` device driver.



Parameters

==========



.. list-table:: Driver-specific parameters implemented

  :widths: 5 5 5 85



  * - Name

    - Type

    - Mode

    - Description

  * - ``best_effort_vlan_filtering``

    - Boolean

    - runtime

    - Allow plain ETH_P_8021Q headers to be used as DSA tags.



      Benefits:



      - Can terminate untagged traffic over switch net

        devices even when enslaved to a bridge with

        vlan_filtering=1.

      - Can terminate VLAN-tagged traffic over switch net

        devices even when enslaved to a bridge with

        vlan_filtering=1, with some constraints (no more than

        7 non-pvid VLANs per user port).

      - Can do QoS based on VLAN PCP and VLAN membership

        admission control for autonomously forwarded frames

        (regardless of whether they can be terminated on the

        CPU or not).



      Drawbacks:



      - User cannot use VLANs in range 1024-3071. If the

	switch receives frames with such VIDs, it will

	misinterpret them as DSA tags.

      - Switch uses Shared VLAN Learning (FDB lookup uses

	only DMAC as key).

      - When VLANs span cross-chip topologies, the total

	number of permitted VLANs may be less than 7 per

	port, due to a maximum number of 32 VLAN retagging

	rules per switch.