docs: sphinx-requirements: Move sphinx_rtd_theme to top
[linux-2.6-microblaze.git] / Documentation / networking / devlink / sja1105.rst
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.