Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: net: dsa: document the new methods for bridge TX forwarding offload

Two new methods have been introduced, add some verbiage about what they do.

Signed-off-by: Vladimir Oltean <vladimir.oltean@nxp.com>
Signed-off-by: David S. Miller <davem@davemloft.net>

authored by

Vladimir Oltean and committed by
David S. Miller
95ca3819 37f299d9

+16
+16
Documentation/networking/dsa/dsa.rst
··· 650 650 CPU port, and flooding towards the CPU port should also be enabled, due to a 651 651 lack of an explicit address filtering mechanism in the DSA core. 652 652 653 + - ``port_bridge_tx_fwd_offload``: bridge layer function invoked after 654 + ``port_bridge_join`` when a driver sets ``ds->num_fwd_offloading_bridges`` to 655 + a non-zero value. Returning success in this function activates the TX 656 + forwarding offload bridge feature for this port, which enables the tagging 657 + protocol driver to inject data plane packets towards the bridging domain that 658 + the port is a part of. Data plane packets are subject to FDB lookup, hardware 659 + learning on the CPU port, and do not override the port STP state. 660 + Additionally, replication of data plane packets (multicast, flooding) is 661 + handled in hardware and the bridge driver will transmit a single skb for each 662 + packet that needs replication. The method is provided as a configuration 663 + point for drivers that need to configure the hardware for enabling this 664 + feature. 665 + 666 + - ``port_bridge_tx_fwd_unoffload``: bridge layer function invoken when a driver 667 + leaves a bridge port which had the TX forwarding offload feature enabled. 668 + 653 669 Bridge VLAN filtering 654 670 --------------------- 655 671