Skip to content

Commit ae0b829

Browse files
kuba-moodavem330
authored andcommitted
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: Jakub Kicinski <[email protected]> Acked-by: Vladimir Oltean <[email protected]> Tested-by: Vladimir Oltean <[email protected]> Signed-off-by: David S. Miller <[email protected]>
1 parent b548493 commit ae0b829

File tree

3 files changed

+50
-27
lines changed

3 files changed

+50
-27
lines changed

Documentation/networking/devlink-params-sja1105.txt

Lines changed: 0 additions & 27 deletions
This file was deleted.

Documentation/networking/devlink/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,5 +40,6 @@ parameters, info versions, and other features it supports.
4040
mv88e6xxx
4141
netdevsim
4242
nfp
43+
sja1105
4344
qed
4445
ti-cpsw-switch
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
.. SPDX-License-Identifier: GPL-2.0
2+
3+
=======================
4+
sja1105 devlink support
5+
=======================
6+
7+
This document describes the devlink features implemented
8+
by the ``sja1105`` device driver.
9+
10+
Parameters
11+
==========
12+
13+
.. list-table:: Driver-specific parameters implemented
14+
:widths: 5 5 5 85
15+
16+
* - Name
17+
- Type
18+
- Mode
19+
- Description
20+
* - ``best_effort_vlan_filtering``
21+
- Boolean
22+
- runtime
23+
- Allow plain ETH_P_8021Q headers to be used as DSA tags.
24+
25+
Benefits:
26+
27+
- Can terminate untagged traffic over switch net
28+
devices even when enslaved to a bridge with
29+
vlan_filtering=1.
30+
- Can terminate VLAN-tagged traffic over switch net
31+
devices even when enslaved to a bridge with
32+
vlan_filtering=1, with some constraints (no more than
33+
7 non-pvid VLANs per user port).
34+
- Can do QoS based on VLAN PCP and VLAN membership
35+
admission control for autonomously forwarded frames
36+
(regardless of whether they can be terminated on the
37+
CPU or not).
38+
39+
Drawbacks:
40+
41+
- User cannot use VLANs in range 1024-3071. If the
42+
switch receives frames with such VIDs, it will
43+
misinterpret them as DSA tags.
44+
- Switch uses Shared VLAN Learning (FDB lookup uses
45+
only DMAC as key).
46+
- When VLANs span cross-chip topologies, the total
47+
number of permitted VLANs may be less than 7 per
48+
port, due to a maximum number of 32 VLAN retagging
49+
rules per switch.

0 commit comments

Comments
 (0)