1.. SPDX-License-Identifier: GPL-2.0
2
3=======================
4sja1105 devlink support
5=======================
6
7This document describes the devlink features implemented
8by the ``sja1105`` device driver.
9
10Parameters
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.
50