Vsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget%/translations/zh_CN/networking/bridgemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/zh_TW/networking/bridgemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/it_IT/networking/bridgemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ja_JP/networking/bridgemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ko_KR/networking/bridgemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/pt_BR/networking/bridgemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/sp_SP/networking/bridgemodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh?/var/lib/git/docbuild/linux/Documentation/networking/bridge.rsthKubhsection)}(hhh](htitle)}(hEthernet Bridgingh]hEthernet Bridging}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Introductionh]h Introduction}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hXThe IEEE 802.1Q-2022 (Bridges and Bridged Networks) standard defines the operation of bridges in computer networks. A bridge, in the context of this standard, is a device that connects two or more network segments and operates at the data link layer (Layer 2) of the OSI (Open Systems Interconnection) model. The purpose of a bridge is to filter and forward frames between different segments based on the destination MAC (Media Access Control) address.h]hXThe IEEE 802.1Q-2022 (Bridges and Bridged Networks) standard defines the operation of bridges in computer networks. A bridge, in the context of this standard, is a device that connects two or more network segments and operates at the data link layer (Layer 2) of the OSI (Open Systems Interconnection) model. The purpose of a bridge is to filter and forward frames between different segments based on the destination MAC (Media Access Control) address.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Bridge kAPIh]h Bridge kAPI}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hoHere are some core structures of bridge code. Note that the kAPI is *unstable*, and can be changed at any time.h](hDHere are some core structures of bridge code. Note that the kAPI is }(hjhhhNhNubhemphasis)}(h *unstable*h]hunstable}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh!, and can be changed at any time.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlenet_bridge_vlan (C struct)c.net_bridge_vlanhNtauh1j9hjhhhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhNubhdesc)}(hhh](hdesc_signature)}(hnet_bridge_vlanh]hdesc_signature_line)}(hstruct net_bridge_vlanh](hdesc_sig_keyword)}(hstructh]hstruct}(hj^hhhNhNubah}(h]h ]kah"]h$]h&]uh1j\hjXhhhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKubhdesc_sig_space)}(h h]h }(hjphhhNhNubah}(h]h ]wah"]h$]h&]uh1jnhjXhhhjmhKubh desc_name)}(hnet_bridge_vlanh]h desc_sig_name)}(hjTh]hnet_bridge_vlan}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjXhhhjmhKubeh}(h]h ]h"]h$]h&]hhƌ add_permalinkuh1jVsphinx_line_type declaratorhjRhhhjmhKubah}(h]jHah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jPhjmhKhjMhhubh desc_content)}(hhh]h)}(hper-vlan entryh]hper-vlan entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjMhhhjmhKubeh}(h]h ](cstructeh"]h$]h&]domainjobjtypejdesctypejnoindex noindexentrynocontentsentryuh1jKhhhjhjJhNubh container)}(hX**Definition**:: struct net_bridge_vlan { struct rhash_head vnode; struct rhash_head tnode; u16 vid; u16 flags; u16 priv_flags; u8 state; struct pcpu_sw_netstats __percpu *stats; union { struct net_bridge *br; struct net_bridge_port *port; }; union { refcount_t refcnt; struct net_bridge_vlan *brvlan; }; struct br_tunnel_info tinfo; union { struct net_bridge_mcast br_mcast_ctx; struct net_bridge_mcast_port port_mcast_ctx; }; u16 msti; struct net_bridge_vlan_port_array *port_array; struct list_head port_vlist; struct list_head vlist; struct rcu_head rcu; }; **Members** ``vnode`` rhashtable member ``tnode`` rhashtable member ``vid`` VLAN id ``flags`` bridge vlan flags ``priv_flags`` private (in-kernel) bridge vlan flags ``state`` STP state (e.g. blocking, learning, forwarding) ``stats`` per-cpu VLAN statistics ``{unnamed_union}`` anonymous ``br`` if MASTER flag set, this points to a bridge struct ``port`` if MASTER flag unset, this points to a port struct ``{unnamed_union}`` anonymous ``refcnt`` if MASTER flag set, this is bumped for each port referencing it ``brvlan`` if MASTER flag unset, this points to the global per-VLAN context for this VLAN entry ``tinfo`` bridge tunnel info ``{unnamed_union}`` anonymous ``br_mcast_ctx`` if MASTER flag set, this is the global vlan multicast context ``port_mcast_ctx`` if MASTER flag unset, this is the per-port/vlan multicast context ``msti`` if MASTER flag set, this holds the VLANs MST instance ``port_array`` if MASTER flag set, this is the port-VLAN array ``port_vlist`` if MASTER flag set, this is the port-VLAN list ``vlist`` sorted list of VLAN entries ``rcu`` used for entry destructionh](h)}(h**Definition**::h](hstrong)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubh literal_block)}(hXstruct net_bridge_vlan { struct rhash_head vnode; struct rhash_head tnode; u16 vid; u16 flags; u16 priv_flags; u8 state; struct pcpu_sw_netstats __percpu *stats; union { struct net_bridge *br; struct net_bridge_port *port; }; union { refcount_t refcnt; struct net_bridge_vlan *brvlan; }; struct br_tunnel_info tinfo; union { struct net_bridge_mcast br_mcast_ctx; struct net_bridge_mcast_port port_mcast_ctx; }; u16 msti; struct net_bridge_vlan_port_array *port_array; struct list_head port_vlist; struct list_head vlist; struct rcu_head rcu; };h]hXstruct net_bridge_vlan { struct rhash_head vnode; struct rhash_head tnode; u16 vid; u16 flags; u16 priv_flags; u8 state; struct pcpu_sw_netstats __percpu *stats; union { struct net_bridge *br; struct net_bridge_port *port; }; union { refcount_t refcnt; struct net_bridge_vlan *brvlan; }; struct br_tunnel_info tinfo; union { struct net_bridge_mcast br_mcast_ctx; struct net_bridge_mcast_port port_mcast_ctx; }; u16 msti; struct net_bridge_vlan_port_array *port_array; struct list_head port_vlist; struct list_head vlist; struct rcu_head rcu; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubhdefinition_list)}(hhh](hdefinition_list_item)}(h``vnode`` rhashtable member h](hterm)}(h ``vnode``h]hliteral)}(hj6h]hvnode}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj4ubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhj.ubh definition)}(hhh]h)}(hrhashtable memberh]hrhashtable member}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhKhjPubah}(h]h ]h"]h$]h&]uh1jNhj.ubeh}(h]h ]h"]h$]h&]uh1j,hjMhKhj)ubj-)}(h``tnode`` rhashtable member h](j3)}(h ``tnode``h]j9)}(hjsh]htnode}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjqubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjmubjO)}(hhh]h)}(hrhashtable memberh]hrhashtable member}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjmubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h``vid`` VLAN id h](j3)}(h``vid``h]j9)}(hjh]hvid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hVLAN idh]hVLAN id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h``flags`` bridge vlan flags h](j3)}(h ``flags``h]j9)}(hjh]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hbridge vlan flagsh]hbridge vlan flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h5``priv_flags`` private (in-kernel) bridge vlan flags h](j3)}(h``priv_flags``h]j9)}(hjh]h priv_flags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(h%private (in-kernel) bridge vlan flagsh]h%private (in-kernel) bridge vlan flags}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hKhj4ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj3hKhj)ubj-)}(h:``state`` STP state (e.g. blocking, learning, forwarding) h](j3)}(h ``state``h]j9)}(hjWh]hstate}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjUubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjQubjO)}(hhh]h)}(h/STP state (e.g. blocking, learning, forwarding)h]h/STP state (e.g. blocking, learning, forwarding)}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhKhjmubah}(h]h ]h"]h$]h&]uh1jNhjQubeh}(h]h ]h"]h$]h&]uh1j,hjlhKhj)ubj-)}(h"``stats`` per-cpu VLAN statistics h](j3)}(h ``stats``h]j9)}(hjh]hstats}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hper-cpu VLAN statisticsh]hper-cpu VLAN statistics}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h``{unnamed_union}`` anonymous h](j3)}(h``{unnamed_union}``h]j9)}(hjh]h{unnamed_union}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h:``br`` if MASTER flag set, this points to a bridge struct h](j3)}(h``br``h]j9)}(hjh]hbr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(h2if MASTER flag set, this points to a bridge structh]h2if MASTER flag set, this points to a bridge struct}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h<``port`` if MASTER flag unset, this points to a port struct h](j3)}(h``port``h]j9)}(hj;h]hport}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj9ubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhj5ubjO)}(hhh]h)}(h2if MASTER flag unset, this points to a port structh]h2if MASTER flag unset, this points to a port struct}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhKhjQubah}(h]h ]h"]h$]h&]uh1jNhj5ubeh}(h]h ]h"]h$]h&]uh1j,hjPhKhj)ubj-)}(h``{unnamed_union}`` anonymous h](j3)}(h``{unnamed_union}``h]j9)}(hjth]h{unnamed_union}}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjrubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjnubjO)}(hhh]h)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjnubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(hK``refcnt`` if MASTER flag set, this is bumped for each port referencing it h](j3)}(h ``refcnt``h]j9)}(hjh]hrefcnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(h?if MASTER flag set, this is bumped for each port referencing ith]h?if MASTER flag set, this is bumped for each port referencing it}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h```brvlan`` if MASTER flag unset, this points to the global per-VLAN context for this VLAN entry h](j3)}(h ``brvlan``h]j9)}(hjh]hbrvlan}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hTif MASTER flag unset, this points to the global per-VLAN context for this VLAN entryh]hTif MASTER flag unset, this points to the global per-VLAN context for this VLAN entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h``tinfo`` bridge tunnel info h](j3)}(h ``tinfo``h]j9)}(hj h]htinfo}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hbridge tunnel infoh]hbridge tunnel info}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hKhj6ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj5hKhj)ubj-)}(h``{unnamed_union}`` anonymous h](j3)}(h``{unnamed_union}``h]j9)}(hjYh]h{unnamed_union}}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjWubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjSubjO)}(hhh]h)}(h anonymoush]h anonymous}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhKhjoubah}(h]h ]h"]h$]h&]uh1jNhjSubeh}(h]h ]h"]h$]h&]uh1j,hjnhKhj)ubj-)}(hO``br_mcast_ctx`` if MASTER flag set, this is the global vlan multicast context h](j3)}(h``br_mcast_ctx``h]j9)}(hjh]h br_mcast_ctx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(h=if MASTER flag set, this is the global vlan multicast contexth]h=if MASTER flag set, this is the global vlan multicast context}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(hU``port_mcast_ctx`` if MASTER flag unset, this is the per-port/vlan multicast context h](j3)}(h``port_mcast_ctx``h]j9)}(hjh]hport_mcast_ctx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hAif MASTER flag unset, this is the per-port/vlan multicast contexth]hAif MASTER flag unset, this is the per-port/vlan multicast context}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h?``msti`` if MASTER flag set, this holds the VLANs MST instance h](j3)}(h``msti``h]j9)}(hjh]hmsti}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(h5if MASTER flag set, this holds the VLANs MST instanceh]h5if MASTER flag set, this holds the VLANs MST instance}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h?``port_array`` if MASTER flag set, this is the port-VLAN array h](j3)}(h``port_array``h]j9)}(hj>h]h port_array}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj<ubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhj8ubjO)}(hhh]h)}(h/if MASTER flag set, this is the port-VLAN arrayh]h/if MASTER flag set, this is the port-VLAN array}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShKhjTubah}(h]h ]h"]h$]h&]uh1jNhj8ubeh}(h]h ]h"]h$]h&]uh1j,hjShKhj)ubj-)}(h>``port_vlist`` if MASTER flag set, this is the port-VLAN list h](j3)}(h``port_vlist``h]j9)}(hjwh]h port_vlist}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjuubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjqubjO)}(hhh]h)}(h.if MASTER flag set, this is the port-VLAN listh]h.if MASTER flag set, this is the port-VLAN list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjqubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h&``vlist`` sorted list of VLAN entries h](j3)}(h ``vlist``h]j9)}(hjh]hvlist}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hsorted list of VLAN entriesh]hsorted list of VLAN entries}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubj-)}(h"``rcu`` used for entry destructionh](j3)}(h``rcu``h]j9)}(hjh]hrcu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubah}(h]h ]h"]h$]h&]uh1j2hY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubjO)}(hhh]h)}(hused for entry destructionh]hused for entry destruction}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhKhj)ubeh}(h]h ]h"]h$]h&]uh1j'hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhjJhNubh)}(h**Description**h]j)}(hj,h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjhhubh)}(hThis structure is shared between the global per-VLAN entries contained in the bridge rhashtable and the local per-port per-VLAN entries contained in the port's rhashtable. The union entries should be interpreted depending on the entry flags that are set.h]hXThis structure is shared between the global per-VLAN entries contained in the bridge rhashtable and the local per-port per-VLAN entries contained in the port’s rhashtable. The union entries should be interpreted depending on the entry flags that are set.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/networking/bridge:23: ./net/bridge/br_private.hhKhjhhubeh}(h] bridge-kapiah ]h"] bridge kapiah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Bridge uAPIh]h Bridge uAPI}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhhhhhKubh)}(hModern Linux bridge uAPI is accessed via Netlink interface. You can find below files where the bridge and bridge port netlink attributes are defined.h]hModern Linux bridge uAPI is accessed via Netlink interface. You can find below files where the bridge and bridge port netlink attributes are defined.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjYhhubh)}(hhh](h)}(hBridge netlink attributesh]hBridge netlink attributes}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjxhhhhhK!ubh)}(hPlease *note* that the timer values in the following section are expected in clock_t format, which is seconds multiplied by USER_HZ (generally defined as 100).h](hPlease }(hjhhhNhNubj )}(h*note*h]hnote}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh that the timer values in the following section are expected in clock_t format, which is seconds multiplied by USER_HZ (generally defined as 100).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjxhhubj()}(hhh](j-)}(hX2**IFLA_BR_FORWARD_DELAY** The bridge forwarding delay is the time spent in LISTENING state (before moving to LEARNING) and in LEARNING state (before moving to FORWARDING). Only relevant if STP is enabled. The valid values are between (2 * USER_HZ) and (30 * USER_HZ). The default value is (15 * USER_HZ). h](j3)}(h**IFLA_BR_FORWARD_DELAY**h]j)}(hjh]hIFLA_BR_FORWARD_DELAY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hThe bridge forwarding delay is the time spent in LISTENING state (before moving to LEARNING) and in LEARNING state (before moving to FORWARDING). Only relevant if STP is enabled.h]hThe bridge forwarding delay is the time spent in LISTENING state (before moving to LEARNING) and in LEARNING state (before moving to FORWARDING). Only relevant if STP is enabled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(hcThe valid values are between (2 * USER_HZ) and (30 * USER_HZ). The default value is (15 * USER_HZ).h]hcThe valid values are between (2 * USER_HZ) and (30 * USER_HZ). The default value is (15 * USER_HZ).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hX**IFLA_BR_HELLO_TIME** The time between hello packets sent by the bridge, when it is a root bridge or a designated bridge. Only relevant if STP is enabled. The valid values are between (1 * USER_HZ) and (10 * USER_HZ). The default value is (2 * USER_HZ). h](j3)}(h**IFLA_BR_HELLO_TIME**h]j)}(hjh]hIFLA_BR_HELLO_TIME}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hThe time between hello packets sent by the bridge, when it is a root bridge or a designated bridge. Only relevant if STP is enabled.h]hThe time between hello packets sent by the bridge, when it is a root bridge or a designated bridge. Only relevant if STP is enabled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(hbThe valid values are between (1 * USER_HZ) and (10 * USER_HZ). The default value is (2 * USER_HZ).h]hbThe valid values are between (1 * USER_HZ) and (10 * USER_HZ). The default value is (2 * USER_HZ).}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hX+**IFLA_BR_MAX_AGE** The hello packet timeout is the time until another bridge in the spanning tree is assumed to be dead, after reception of its last hello message. Only relevant if STP is enabled. The valid values are between (6 * USER_HZ) and (40 * USER_HZ). The default value is (20 * USER_HZ). h](j3)}(h**IFLA_BR_MAX_AGE**h]j)}(hjEh]hIFLA_BR_MAX_AGE}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj?ubjO)}(hhh](h)}(hThe hello packet timeout is the time until another bridge in the spanning tree is assumed to be dead, after reception of its last hello message. Only relevant if STP is enabled.h]hThe hello packet timeout is the time until another bridge in the spanning tree is assumed to be dead, after reception of its last hello message. Only relevant if STP is enabled.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj[ubh)}(hcThe valid values are between (6 * USER_HZ) and (40 * USER_HZ). The default value is (20 * USER_HZ).h]hcThe valid values are between (6 * USER_HZ) and (40 * USER_HZ). The default value is (20 * USER_HZ).}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj[ubeh}(h]h ]h"]h$]h&]uh1jNhj?ubeh}(h]h ]h"]h$]h&]uh1j,hjZhMhjubj-)}(hX**IFLA_BR_AGEING_TIME** Configure the bridge's FDB entries aging time. It is the time a MAC address will be kept in the FDB after a packet has been received from that address. After this time has passed, entries are cleaned up. Allow values outside the 802.1 standard specification for special cases: * 0 - entry never ages (all permanent) * 1 - entry disappears (no persistence) The default value is (300 * USER_HZ). h](j3)}(h**IFLA_BR_AGEING_TIME**h]j)}(hjh]hIFLA_BR_AGEING_TIME}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hXConfigure the bridge's FDB entries aging time. It is the time a MAC address will be kept in the FDB after a packet has been received from that address. After this time has passed, entries are cleaned up. Allow values outside the 802.1 standard specification for special cases:h]hXConfigure the bridge’s FDB entries aging time. It is the time a MAC address will be kept in the FDB after a packet has been received from that address. After this time has passed, entries are cleaned up. Allow values outside the 802.1 standard specification for special cases:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh block_quote)}(hO* 0 - entry never ages (all permanent) * 1 - entry disappears (no persistence) h]h bullet_list)}(hhh](h list_item)}(h$0 - entry never ages (all permanent)h]h)}(hjh]h$0 - entry never ages (all permanent)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h&1 - entry disappears (no persistence) h]h)}(h%1 - entry disappears (no persistence)h]h%1 - entry disappears (no persistence)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]bullet*uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjhMhjubh)}(h%The default value is (300 * USER_HZ).h]h%The default value is (300 * USER_HZ).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_STP_STATE** Turn spanning tree protocol on (*IFLA_BR_STP_STATE* > 0) or off (*IFLA_BR_STP_STATE* == 0) for this bridge. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_STP_STATE**h]j)}(hj" h]hIFLA_BR_STP_STATE}(hj$ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubjO)}(hhh](h)}(hkTurn spanning tree protocol on (*IFLA_BR_STP_STATE* > 0) or off (*IFLA_BR_STP_STATE* == 0) for this bridge.h](h Turn spanning tree protocol on (}(hj; hhhNhNubj )}(h*IFLA_BR_STP_STATE*h]hIFLA_BR_STP_STATE}(hjC hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj; ubh > 0) or off (}(hj; hhhNhNubj )}(h*IFLA_BR_STP_STATE*h]hIFLA_BR_STP_STATE}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj; ubh == 0) for this bridge.}(hj; hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj8 ubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjn hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7 hMhj8 ubeh}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj7 hMhjubj-)}(h**IFLA_BR_PRIORITY** Set this bridge's spanning tree priority, used during STP root bridge election. The valid values are between 0 and 65535. h](j3)}(h**IFLA_BR_PRIORITY**h]j)}(hj h]hIFLA_BR_PRIORITY}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubjO)}(hhh](h)}(hOSet this bridge's spanning tree priority, used during STP root bridge election.h]hQSet this bridge’s spanning tree priority, used during STP root bridge election.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubh)}(h)The valid values are between 0 and 65535.h]h)The valid values are between 0 and 65535.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubeh}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hMhjubj-)}(h**IFLA_BR_VLAN_FILTERING** Turn VLAN filtering on (*IFLA_BR_VLAN_FILTERING* > 0) or off (*IFLA_BR_VLAN_FILTERING* == 0). When disabled, the bridge will not consider the VLAN tag when handling packets. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_VLAN_FILTERING**h]j)}(hj h]hIFLA_BR_VLAN_FILTERING}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM hj ubjO)}(hhh](h)}(hTurn VLAN filtering on (*IFLA_BR_VLAN_FILTERING* > 0) or off (*IFLA_BR_VLAN_FILTERING* == 0). When disabled, the bridge will not consider the VLAN tag when handling packets.h](hTurn VLAN filtering on (}(hj hhhNhNubj )}(h*IFLA_BR_VLAN_FILTERING*h]hIFLA_BR_VLAN_FILTERING}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh > 0) or off (}(hj hhhNhNubj )}(h*IFLA_BR_VLAN_FILTERING*h]hIFLA_BR_VLAN_FILTERING}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhW == 0). When disabled, the bridge will not consider the VLAN tag when handling packets.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM hj ubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hj" hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM hj ubeh}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hM hjubj-)}(h**IFLA_BR_VLAN_PROTOCOL** Set the protocol used for VLAN filtering. The valid values are 0x8100(802.1Q) or 0x88A8(802.1AD). The default value is 0x8100(802.1Q). h](j3)}(h**IFLA_BR_VLAN_PROTOCOL**h]j)}(hjB h]hIFLA_BR_VLAN_PROTOCOL}(hjD hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj< ubjO)}(hhh](h)}(h)Set the protocol used for VLAN filtering.h]h)Set the protocol used for VLAN filtering.}(hj[ hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjX ubh)}(h\The valid values are 0x8100(802.1Q) or 0x88A8(802.1AD). The default value is 0x8100(802.1Q).h]h\The valid values are 0x8100(802.1Q) or 0x88A8(802.1AD). The default value is 0x8100(802.1Q).}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjX ubeh}(h]h ]h"]h$]h&]uh1jNhj< ubeh}(h]h ]h"]h$]h&]uh1j,hjW hMhjubj-)}(hX5**IFLA_BR_GROUP_FWD_MASK** The group forwarding mask. This is the bitmask that is applied to decide whether to forward incoming frames destined to link-local addresses (of the form 01:80:C2:00:00:0X). The default value is 0, which means the bridge does not forward any link-local frames coming on this port. h](j3)}(h**IFLA_BR_GROUP_FWD_MASK**h]j)}(hj h]hIFLA_BR_GROUP_FWD_MASK}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubjO)}(hhh](h)}(hThe group forwarding mask. This is the bitmask that is applied to decide whether to forward incoming frames destined to link-local addresses (of the form 01:80:C2:00:00:0X).h]hThe group forwarding mask. This is the bitmask that is applied to decide whether to forward incoming frames destined to link-local addresses (of the form 01:80:C2:00:00:0X).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubh)}(hjThe default value is 0, which means the bridge does not forward any link-local frames coming on this port.h]hjThe default value is 0, which means the bridge does not forward any link-local frames coming on this port.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubeh}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hMhjubj-)}(h3**IFLA_BR_ROOT_ID** The bridge root id, read only. h](j3)}(h**IFLA_BR_ROOT_ID**h]j)}(hj h]hIFLA_BR_ROOT_ID}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubjO)}(hhh]h)}(hThe bridge root id, read only.h]hThe bridge root id, read only.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hMhjubj-)}(h0**IFLA_BR_BRIDGE_ID** The bridge id, read only. h](j3)}(h**IFLA_BR_BRIDGE_ID**h]j)}(hj h]hIFLA_BR_BRIDGE_ID}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM!hj ubjO)}(hhh]h)}(hThe bridge id, read only.h]hThe bridge id, read only.}(hj& hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj" hM!hj# ubah}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj" hM!hjubj-)}(h7**IFLA_BR_ROOT_PORT** The bridge root port, read only. h](j3)}(h**IFLA_BR_ROOT_PORT**h]j)}(hjF h]hIFLA_BR_ROOT_PORT}(hjH hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjD ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM$hj@ ubjO)}(hhh]h)}(h The bridge root port, read only.h]h The bridge root port, read only.}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[ hM$hj\ ubah}(h]h ]h"]h$]h&]uh1jNhj@ ubeh}(h]h ]h"]h$]h&]uh1j,hj[ hM$hjubj-)}(hA**IFLA_BR_ROOT_PATH_COST** The bridge root path cost, read only. h](j3)}(h**IFLA_BR_ROOT_PATH_COST**h]j)}(hj h]hIFLA_BR_ROOT_PATH_COST}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj} ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM'hjy ubjO)}(hhh]h)}(h%The bridge root path cost, read only.h]h%The bridge root path cost, read only.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM'hj ubah}(h]h ]h"]h$]h&]uh1jNhjy ubeh}(h]h ]h"]h$]h&]uh1j,hj hM'hjubj-)}(hC**IFLA_BR_TOPOLOGY_CHANGE** The bridge topology change, read only. h](j3)}(h**IFLA_BR_TOPOLOGY_CHANGE**h]j)}(hj h]hIFLA_BR_TOPOLOGY_CHANGE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM*hj ubjO)}(hhh]h)}(h&The bridge topology change, read only.h]h&The bridge topology change, read only.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM*hj ubah}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hM*hjubj-)}(hU**IFLA_BR_TOPOLOGY_CHANGE_DETECTED** The bridge topology change detected, read only. h](j3)}(h$**IFLA_BR_TOPOLOGY_CHANGE_DETECTED**h]j)}(hj h]h IFLA_BR_TOPOLOGY_CHANGE_DETECTED}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM-hj ubjO)}(hhh]h)}(h/The bridge topology change detected, read only.h]h/The bridge topology change detected, read only.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM-hj ubah}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hM-hjubj-)}(h;**IFLA_BR_HELLO_TIMER** The bridge hello timer, read only. h](j3)}(h**IFLA_BR_HELLO_TIMER**h]j)}(hj* h]hIFLA_BR_HELLO_TIMER}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj( ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM0hj$ ubjO)}(hhh]h)}(h"The bridge hello timer, read only.h]h"The bridge hello timer, read only.}(hjC hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj? hM0hj@ ubah}(h]h ]h"]h$]h&]uh1jNhj$ ubeh}(h]h ]h"]h$]h&]uh1j,hj? hM0hjubj-)}(h7**IFLA_BR_TCN_TIMER** The bridge tcn timer, read only. h](j3)}(h**IFLA_BR_TCN_TIMER**h]j)}(hjc h]hIFLA_BR_TCN_TIMER}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM3hj] ubjO)}(hhh]h)}(h The bridge tcn timer, read only.h]h The bridge tcn timer, read only.}(hj| hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjx hM3hjy ubah}(h]h ]h"]h$]h&]uh1jNhj] ubeh}(h]h ]h"]h$]h&]uh1j,hjx hM3hjubj-)}(hO**IFLA_BR_TOPOLOGY_CHANGE_TIMER** The bridge topology change timer, read only. h](j3)}(h!**IFLA_BR_TOPOLOGY_CHANGE_TIMER**h]j)}(hj h]hIFLA_BR_TOPOLOGY_CHANGE_TIMER}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM6hj ubjO)}(hhh]h)}(h,The bridge topology change timer, read only.h]h,The bridge topology change timer, read only.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM6hj ubah}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hM6hjubj-)}(h5**IFLA_BR_GC_TIMER** The bridge gc timer, read only. h](j3)}(h**IFLA_BR_GC_TIMER**h]j)}(hj h]hIFLA_BR_GC_TIMER}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM9hj ubjO)}(hhh]h)}(hThe bridge gc timer, read only.h]hThe bridge gc timer, read only.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM9hj ubah}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hM9hjubj-)}(hX **IFLA_BR_GROUP_ADDR** Set the MAC address of the multicast group this bridge uses for STP. The address must be a link-local address in standard Ethernet MAC address format. It is an address of the form 01:80:C2:00:00:0X, with X in [0, 4..f]. The default value is 0. h](j3)}(h**IFLA_BR_GROUP_ADDR**h]j)}(hj h]hIFLA_BR_GROUP_ADDR}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM@hj ubjO)}(hhh](h)}(hSet the MAC address of the multicast group this bridge uses for STP. The address must be a link-local address in standard Ethernet MAC address format. It is an address of the form 01:80:C2:00:00:0X, with X in [0, 4..f].h]hSet the MAC address of the multicast group this bridge uses for STP. The address must be a link-local address in standard Ethernet MAC address format. It is an address of the form 01:80:C2:00:00:0X, with X in [0, 4..f].}(hj' hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM<hj$ ubh)}(hThe default value is 0.h]hThe default value is 0.}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj# hM@hj$ ubeh}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj# hM@hjubj-)}(h:**IFLA_BR_FDB_FLUSH** Flush bridge's fdb dynamic entries. h](j3)}(h**IFLA_BR_FDB_FLUSH**h]j)}(hjV h]hIFLA_BR_FDB_FLUSH}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMChjP ubjO)}(hhh]h)}(h#Flush bridge's fdb dynamic entries.h]h%Flush bridge’s fdb dynamic entries.}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjk hMChjl ubah}(h]h ]h"]h$]h&]uh1jNhjP ubeh}(h]h ]h"]h$]h&]uh1j,hjk hMChjubj-)}(h**IFLA_BR_MCAST_ROUTER** Set bridge's multicast router if IGMP snooping is enabled. The valid values are: * 0 - disabled. * 1 - automatic (queried). * 2 - permanently enabled. The default value is 1. h](j3)}(h**IFLA_BR_MCAST_ROUTER**h]j)}(hj h]hIFLA_BR_MCAST_ROUTER}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMMhj ubjO)}(hhh](h)}(hPSet bridge's multicast router if IGMP snooping is enabled. The valid values are:h]hRSet bridge’s multicast router if IGMP snooping is enabled. The valid values are:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMFhj ubj)}(hF* 0 - disabled. * 1 - automatic (queried). * 2 - permanently enabled. h]j)}(hhh](j)}(h 0 - disabled.h]h)}(hj h]h 0 - disabled.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMIhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h1 - automatic (queried).h]h)}(hj h]h1 - automatic (queried).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMJhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h2 - permanently enabled. h]h)}(h2 - permanently enabled.h]h2 - permanently enabled.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]jjuh1jhj hMIhj ubah}(h]h ]h"]h$]h&]uh1jhj hMIhj ubh)}(hThe default value is 1.h]hThe default value is 1.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMMhj ubeh}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hMMhjubj-)}(h**IFLA_BR_MCAST_SNOOPING** Turn multicast snooping on (*IFLA_BR_MCAST_SNOOPING* > 0) or off (*IFLA_BR_MCAST_SNOOPING* == 0). The default value is 1. h](j3)}(h**IFLA_BR_MCAST_SNOOPING**h]j)}(hj3h]hIFLA_BR_MCAST_SNOOPING}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMShj-ubjO)}(hhh](h)}(haTurn multicast snooping on (*IFLA_BR_MCAST_SNOOPING* > 0) or off (*IFLA_BR_MCAST_SNOOPING* == 0).h](hTurn multicast snooping on (}(hjLhhhNhNubj )}(h*IFLA_BR_MCAST_SNOOPING*h]hIFLA_BR_MCAST_SNOOPING}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubh > 0) or off (}(hjLhhhNhNubj )}(h*IFLA_BR_MCAST_SNOOPING*h]hIFLA_BR_MCAST_SNOOPING}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubh == 0).}(hjLhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMPhjIubh)}(hThe default value is 1.h]hThe default value is 1.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhMShjIubeh}(h]h ]h"]h$]h&]uh1jNhj-ubeh}(h]h ]h"]h$]h&]uh1j,hjHhMShjubj-)}(h**IFLA_BR_MCAST_QUERY_USE_IFADDR** If enabled use the bridge's own IP address as source address for IGMP queries (*IFLA_BR_MCAST_QUERY_USE_IFADDR* > 0) or the default of 0.0.0.0 (*IFLA_BR_MCAST_QUERY_USE_IFADDR* == 0). The default value is 0 (disabled). h](j3)}(h"**IFLA_BR_MCAST_QUERY_USE_IFADDR**h]j)}(hjh]hIFLA_BR_MCAST_QUERY_USE_IFADDR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMZhjubjO)}(hhh](h)}(hIf enabled use the bridge's own IP address as source address for IGMP queries (*IFLA_BR_MCAST_QUERY_USE_IFADDR* > 0) or the default of 0.0.0.0 (*IFLA_BR_MCAST_QUERY_USE_IFADDR* == 0).h](hQIf enabled use the bridge’s own IP address as source address for IGMP queries (}(hjhhhNhNubj )}(h *IFLA_BR_MCAST_QUERY_USE_IFADDR*h]hIFLA_BR_MCAST_QUERY_USE_IFADDR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh! > 0) or the default of 0.0.0.0 (}(hjhhhNhNubj )}(h *IFLA_BR_MCAST_QUERY_USE_IFADDR*h]hIFLA_BR_MCAST_QUERY_USE_IFADDR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh == 0).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMVhjubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMZhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMZhjubj-)}(h**IFLA_BR_MCAST_QUERIER** Enable (*IFLA_BR_MULTICAST_QUERIER* > 0) or disable (*IFLA_BR_MULTICAST_QUERIER* == 0) IGMP querier, ie sending of multicast queries by the bridge. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_MCAST_QUERIER**h]j)}(hj h]hIFLA_BR_MCAST_QUERIER}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMahjubjO)}(hhh](h)}(hEnable (*IFLA_BR_MULTICAST_QUERIER* > 0) or disable (*IFLA_BR_MULTICAST_QUERIER* == 0) IGMP querier, ie sending of multicast queries by the bridge.h](hEnable (}(hj$hhhNhNubj )}(h*IFLA_BR_MULTICAST_QUERIER*h]hIFLA_BR_MULTICAST_QUERIER}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh > 0) or disable (}(hj$hhhNhNubj )}(h*IFLA_BR_MULTICAST_QUERIER*h]hIFLA_BR_MULTICAST_QUERIER}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubhC == 0) IGMP querier, ie sending of multicast queries by the bridge.}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM]hj!ubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMahj!ubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj hMahjubj-)}(h**IFLA_BR_MCAST_HASH_ELASTICITY** Set multicast database hash elasticity, It is the maximum chain length in the multicast hash table. This attribute is *deprecated* and the value is always 16. h](j3)}(h!**IFLA_BR_MCAST_HASH_ELASTICITY**h]j)}(hjwh]hIFLA_BR_MCAST_HASH_ELASTICITY}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMfhjqubjO)}(hhh]h)}(hSet multicast database hash elasticity, It is the maximum chain length in the multicast hash table. This attribute is *deprecated* and the value is always 16.h](hvSet multicast database hash elasticity, It is the maximum chain length in the multicast hash table. This attribute is }(hjhhhNhNubj )}(h *deprecated*h]h deprecated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and the value is always 16.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMdhjubah}(h]h ]h"]h$]h&]uh1jNhjqubeh}(h]h ]h"]h$]h&]uh1j,hjhMfhjubj-)}(h**IFLA_BR_MCAST_HASH_MAX** Set maximum size of the multicast hash table The default value is 4096, the value must be a power of 2. h](j3)}(h**IFLA_BR_MCAST_HASH_MAX**h]j)}(hjh]hIFLA_BR_MCAST_HASH_MAX}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMkhjubjO)}(hhh](h)}(h,Set maximum size of the multicast hash tableh]h,Set maximum size of the multicast hash table}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMihjubh)}(h:The default value is 4096, the value must be a power of 2.h]h:The default value is 4096, the value must be a power of 2.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMkhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMkhjubj-)}(hX]**IFLA_BR_MCAST_LAST_MEMBER_CNT** The Last Member Query Count is the number of Group-Specific Queries sent before the router assumes there are no local members. The Last Member Query Count is also the number of Group-and-Source-Specific Queries sent before the router assumes there are no listeners for a particular source. The default value is 2. h](j3)}(h!**IFLA_BR_MCAST_LAST_MEMBER_CNT**h]j)}(hj h]hIFLA_BR_MCAST_LAST_MEMBER_CNT}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMthjubjO)}(hhh](h)}(hX!The Last Member Query Count is the number of Group-Specific Queries sent before the router assumes there are no local members. The Last Member Query Count is also the number of Group-and-Source-Specific Queries sent before the router assumes there are no listeners for a particular source.h]hX!The Last Member Query Count is the number of Group-Specific Queries sent before the router assumes there are no local members. The Last Member Query Count is also the number of Group-and-Source-Specific Queries sent before the router assumes there are no listeners for a particular source.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMnhj!ubh)}(hThe default value is 2.h]hThe default value is 2.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMthj!ubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj hMthjubj-)}(h**IFLA_BR_MCAST_STARTUP_QUERY_CNT** The Startup Query Count is the number of Queries sent out on startup, separated by the Startup Query Interval. The default value is 2. h](j3)}(h#**IFLA_BR_MCAST_STARTUP_QUERY_CNT**h]j)}(hjSh]hIFLA_BR_MCAST_STARTUP_QUERY_CNT}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMzhjMubjO)}(hhh](h)}(hnThe Startup Query Count is the number of Queries sent out on startup, separated by the Startup Query Interval.h]hnThe Startup Query Count is the number of Queries sent out on startup, separated by the Startup Query Interval.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMwhjiubh)}(hThe default value is 2.h]hThe default value is 2.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMzhjiubeh}(h]h ]h"]h$]h&]uh1jNhjMubeh}(h]h ]h"]h$]h&]uh1j,hjhhMzhjubj-)}(hX**IFLA_BR_MCAST_LAST_MEMBER_INTVL** The Last Member Query Interval is the Max Response Time inserted into Group-Specific Queries sent in response to Leave Group messages, and is also the amount of time between Group-Specific Query messages. The default value is (1 * USER_HZ). h](j3)}(h#**IFLA_BR_MCAST_LAST_MEMBER_INTVL**h]j)}(hjh]hIFLA_BR_MCAST_LAST_MEMBER_INTVL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hThe Last Member Query Interval is the Max Response Time inserted into Group-Specific Queries sent in response to Leave Group messages, and is also the amount of time between Group-Specific Query messages.h]hThe Last Member Query Interval is the Max Response Time inserted into Group-Specific Queries sent in response to Leave Group messages, and is also the amount of time between Group-Specific Query messages.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhM}hjubh)}(h#The default value is (1 * USER_HZ).h]h#The default value is (1 * USER_HZ).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_MCAST_MEMBERSHIP_INTVL** The interval after which the bridge will leave a group, if no membership reports for this group are received. The default value is (260 * USER_HZ). h](j3)}(h"**IFLA_BR_MCAST_MEMBERSHIP_INTVL**h]j)}(hjh]hIFLA_BR_MCAST_MEMBERSHIP_INTVL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hmThe interval after which the bridge will leave a group, if no membership reports for this group are received.h]hmThe interval after which the bridge will leave a group, if no membership reports for this group are received.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(h%The default value is (260 * USER_HZ).h]h%The default value is (260 * USER_HZ).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hX**IFLA_BR_MCAST_QUERIER_INTVL** The interval between queries sent by other routers. if no queries are seen after this delay has passed, the bridge will start to send its own queries (as if *IFLA_BR_MCAST_QUERIER_INTVL* was enabled). The default value is (255 * USER_HZ). h](j3)}(h**IFLA_BR_MCAST_QUERIER_INTVL**h]j)}(hj+h]hIFLA_BR_MCAST_QUERIER_INTVL}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj%ubjO)}(hhh](h)}(hThe interval between queries sent by other routers. if no queries are seen after this delay has passed, the bridge will start to send its own queries (as if *IFLA_BR_MCAST_QUERIER_INTVL* was enabled).h](hThe interval between queries sent by other routers. if no queries are seen after this delay has passed, the bridge will start to send its own queries (as if }(hjDhhhNhNubj )}(h*IFLA_BR_MCAST_QUERIER_INTVL*h]hIFLA_BR_MCAST_QUERIER_INTVL}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubh was enabled).}(hjDhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjAubh)}(h%The default value is (255 * USER_HZ).h]h%The default value is (255 * USER_HZ).}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hMhjAubeh}(h]h ]h"]h$]h&]uh1jNhj%ubeh}(h]h ]h"]h$]h&]uh1j,hj@hMhjubj-)}(h**IFLA_BR_MCAST_QUERY_INTVL** The Query Interval is the interval between General Queries sent by the Querier. The default value is (125 * USER_HZ). The minimum value is (1 * USER_HZ). h](j3)}(h**IFLA_BR_MCAST_QUERY_INTVL**h]j)}(hjh]hIFLA_BR_MCAST_QUERY_INTVL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hOThe Query Interval is the interval between General Queries sent by the Querier.h]hOThe Query Interval is the interval between General Queries sent by the Querier.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(hIThe default value is (125 * USER_HZ). The minimum value is (1 * USER_HZ).h]hIThe default value is (125 * USER_HZ). The minimum value is (1 * USER_HZ).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_MCAST_QUERY_RESPONSE_INTVL** The Max Response Time used to calculate the Max Resp Code inserted into the periodic General Queries. The default value is (10 * USER_HZ). h](j3)}(h&**IFLA_BR_MCAST_QUERY_RESPONSE_INTVL**h]j)}(hjh]h"IFLA_BR_MCAST_QUERY_RESPONSE_INTVL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(heThe Max Response Time used to calculate the Max Resp Code inserted into the periodic General Queries.h]heThe Max Response Time used to calculate the Max Resp Code inserted into the periodic General Queries.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(h$The default value is (10 * USER_HZ).h]h$The default value is (10 * USER_HZ).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_MCAST_STARTUP_QUERY_INTVL** The interval between queries in the startup phase. The default value is (125 * USER_HZ) / 4. The minimum value is (1 * USER_HZ). h](j3)}(h%**IFLA_BR_MCAST_STARTUP_QUERY_INTVL**h]j)}(hjh]h!IFLA_BR_MCAST_STARTUP_QUERY_INTVL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(h2The interval between queries in the startup phase.h]h2The interval between queries in the startup phase.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj+ubh)}(hMThe default value is (125 * USER_HZ) / 4. The minimum value is (1 * USER_HZ).h]hMThe default value is (125 * USER_HZ) / 4. The minimum value is (1 * USER_HZ).}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj+ubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj*hMhjubj-)}(h**IFLA_BR_NF_CALL_IPTABLES** Enable (*NF_CALL_IPTABLES* > 0) or disable (*NF_CALL_IPTABLES* == 0) iptables hooks on the bridge. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_NF_CALL_IPTABLES**h]j)}(hj]h]hIFLA_BR_NF_CALL_IPTABLES}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjWubjO)}(hhh](h)}(hbEnable (*NF_CALL_IPTABLES* > 0) or disable (*NF_CALL_IPTABLES* == 0) iptables hooks on the bridge.h](hEnable (}(hjvhhhNhNubj )}(h*NF_CALL_IPTABLES*h]hNF_CALL_IPTABLES}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubh > 0) or disable (}(hjvhhhNhNubj )}(h*NF_CALL_IPTABLES*h]hNF_CALL_IPTABLES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubh$ == 0) iptables hooks on the bridge.}(hjvhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjsubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMhjsubeh}(h]h ]h"]h$]h&]uh1jNhjWubeh}(h]h ]h"]h$]h&]uh1j,hjrhMhjubj-)}(h**IFLA_BR_NF_CALL_IP6TABLES** Enable (*NF_CALL_IP6TABLES* > 0) or disable (*NF_CALL_IP6TABLES* == 0) ip6tables hooks on the bridge. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_NF_CALL_IP6TABLES**h]j)}(hjh]hIFLA_BR_NF_CALL_IP6TABLES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(heEnable (*NF_CALL_IP6TABLES* > 0) or disable (*NF_CALL_IP6TABLES* == 0) ip6tables hooks on the bridge.h](hEnable (}(hjhhhNhNubj )}(h*NF_CALL_IP6TABLES*h]hNF_CALL_IP6TABLES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh > 0) or disable (}(hjhhhNhNubj )}(h*NF_CALL_IP6TABLES*h]hNF_CALL_IP6TABLES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh% == 0) ip6tables hooks on the bridge.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_NF_CALL_ARPTABLES** Enable (*NF_CALL_ARPTABLES* > 0) or disable (*NF_CALL_ARPTABLES* == 0) arptables hooks on the bridge. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_NF_CALL_ARPTABLES**h]j)}(hj5h]hIFLA_BR_NF_CALL_ARPTABLES}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj/ubjO)}(hhh](h)}(heEnable (*NF_CALL_ARPTABLES* > 0) or disable (*NF_CALL_ARPTABLES* == 0) arptables hooks on the bridge.h](hEnable (}(hjNhhhNhNubj )}(h*NF_CALL_ARPTABLES*h]hNF_CALL_ARPTABLES}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubh > 0) or disable (}(hjNhhhNhNubj )}(h*NF_CALL_ARPTABLES*h]hNF_CALL_ARPTABLES}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubh% == 0) arptables hooks on the bridge.}(hjNhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjKubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhMhjKubeh}(h]h ]h"]h$]h&]uh1jNhj/ubeh}(h]h ]h"]h$]h&]uh1j,hjJhMhjubj-)}(hX**IFLA_BR_VLAN_DEFAULT_PVID** VLAN ID applied to untagged and priority-tagged incoming packets. The default value is 1. Setting to the special value 0 makes all ports of this bridge not have a PVID by default, which means that they will not accept VLAN-untagged traffic. h](j3)}(h**IFLA_BR_VLAN_DEFAULT_PVID**h]j)}(hjh]hIFLA_BR_VLAN_DEFAULT_PVID}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hAVLAN ID applied to untagged and priority-tagged incoming packets.h]hAVLAN ID applied to untagged and priority-tagged incoming packets.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(hThe default value is 1. Setting to the special value 0 makes all ports of this bridge not have a PVID by default, which means that they will not accept VLAN-untagged traffic.h]hThe default value is 1. Setting to the special value 0 makes all ports of this bridge not have a PVID by default, which means that they will not accept VLAN-untagged traffic.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hC**IFLA_BR_PAD** Bridge attribute padding type for netlink message. h](j3)}(h**IFLA_BR_PAD**h]j)}(hjh]h IFLA_BR_PAD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(h2Bridge attribute padding type for netlink message.h]h2Bridge attribute padding type for netlink message.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_VLAN_STATS_ENABLED** Enable (*IFLA_BR_VLAN_STATS_ENABLED* == 1) or disable (*IFLA_BR_VLAN_STATS_ENABLED* == 0) per-VLAN stats accounting. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_VLAN_STATS_ENABLED**h]j)}(hj#h]hIFLA_BR_VLAN_STATS_ENABLED}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(htEnable (*IFLA_BR_VLAN_STATS_ENABLED* == 1) or disable (*IFLA_BR_VLAN_STATS_ENABLED* == 0) per-VLAN stats accounting.h](hEnable (}(hj<hhhNhNubj )}(h*IFLA_BR_VLAN_STATS_ENABLED*h]hIFLA_BR_VLAN_STATS_ENABLED}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubh == 1) or disable (}(hj<hhhNhNubj )}(h*IFLA_BR_VLAN_STATS_ENABLED*h]hIFLA_BR_VLAN_STATS_ENABLED}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubh! == 0) per-VLAN stats accounting.}(hj<hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj9ubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMhj9ubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj8hMhjubj-)}(h**IFLA_BR_MCAST_STATS_ENABLED** Enable (*IFLA_BR_MCAST_STATS_ENABLED* > 0) or disable (*IFLA_BR_MCAST_STATS_ENABLED* == 0) multicast (IGMP/MLD) stats accounting. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_MCAST_STATS_ENABLED**h]j)}(hjh]hIFLA_BR_MCAST_STATS_ENABLED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hEnable (*IFLA_BR_MCAST_STATS_ENABLED* > 0) or disable (*IFLA_BR_MCAST_STATS_ENABLED* == 0) multicast (IGMP/MLD) stats accounting.h](hEnable (}(hjhhhNhNubj )}(h*IFLA_BR_MCAST_STATS_ENABLED*h]hIFLA_BR_MCAST_STATS_ENABLED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh > 0) or disable (}(hjhhhNhNubj )}(h*IFLA_BR_MCAST_STATS_ENABLED*h]hIFLA_BR_MCAST_STATS_ENABLED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh- == 0) multicast (IGMP/MLD) stats accounting.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hl**IFLA_BR_MCAST_IGMP_VERSION** Set the IGMP version. The valid values are 2 and 3. The default value is 2. h](j3)}(h**IFLA_BR_MCAST_IGMP_VERSION**h]j)}(hjh]hIFLA_BR_MCAST_IGMP_VERSION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hSet the IGMP version.h]hSet the IGMP version.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(h5The valid values are 2 and 3. The default value is 2.h]h5The valid values are 2 and 3. The default value is 2.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hj**IFLA_BR_MCAST_MLD_VERSION** Set the MLD version. The valid values are 1 and 2. The default value is 1. h](j3)}(h**IFLA_BR_MCAST_MLD_VERSION**h]j)}(hjCh]hIFLA_BR_MCAST_MLD_VERSION}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj=ubjO)}(hhh](h)}(hSet the MLD version.h]hSet the MLD version.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjYubh)}(h5The valid values are 1 and 2. The default value is 1.h]h5The valid values are 1 and 2. The default value is 1.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMhjYubeh}(h]h ]h"]h$]h&]uh1jNhj=ubeh}(h]h ]h"]h$]h&]uh1j,hjXhMhjubj-)}(hX**IFLA_BR_VLAN_STATS_PER_PORT** Enable (*IFLA_BR_VLAN_STATS_PER_PORT* == 1) or disable (*IFLA_BR_VLAN_STATS_PER_PORT* == 0) per-VLAN per-port stats accounting. Can be changed only when there are no port VLANs configured. The default value is 0 (disabled). h](j3)}(h**IFLA_BR_VLAN_STATS_PER_PORT**h]j)}(hjh]hIFLA_BR_VLAN_STATS_PER_PORT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hEnable (*IFLA_BR_VLAN_STATS_PER_PORT* == 1) or disable (*IFLA_BR_VLAN_STATS_PER_PORT* == 0) per-VLAN per-port stats accounting. Can be changed only when there are no port VLANs configured.h](hEnable (}(hjhhhNhNubj )}(h*IFLA_BR_VLAN_STATS_PER_PORT*h]hIFLA_BR_VLAN_STATS_PER_PORT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh == 1) or disable (}(hjhhhNhNubj )}(h*IFLA_BR_VLAN_STATS_PER_PORT*h]hIFLA_BR_VLAN_STATS_PER_PORT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhg == 0) per-VLAN per-port stats accounting. Can be changed only when there are no port VLANs configured.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubh)}(h"The default value is 0 (disabled).h]h"The default value is 0 (disabled).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_MULTI_BOOLOPT** The multi_boolopt is used to control new boolean options to avoid adding new netlink attributes. You can look at ``enum br_boolopt_id`` for those options. h](j3)}(h**IFLA_BR_MULTI_BOOLOPT**h]j)}(hjh]hIFLA_BR_MULTI_BOOLOPT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hThe multi_boolopt is used to control new boolean options to avoid adding new netlink attributes. You can look at ``enum br_boolopt_id`` for those options.h](hqThe multi_boolopt is used to control new boolean options to avoid adding new netlink attributes. You can look at }(hjhhhNhNubj9)}(h``enum br_boolopt_id``h]henum br_boolopt_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubh for those options.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj hMhjubj-)}(hH**IFLA_BR_MCAST_QUERIER_STATE** Bridge mcast querier states, read only. h](j3)}(h**IFLA_BR_MCAST_QUERIER_STATE**h]j)}(hjCh]hIFLA_BR_MCAST_QUERIER_STATE}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhj=ubjO)}(hhh]h)}(h'Bridge mcast querier states, read only.h]h'Bridge mcast querier states, read only.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMhjYubah}(h]h ]h"]h$]h&]uh1jNhj=ubeh}(h]h ]h"]h$]h&]uh1j,hjXhMhjubj-)}(hk**IFLA_BR_FDB_N_LEARNED** The number of dynamically learned FDB entries for the current bridge, read only. h](j3)}(h**IFLA_BR_FDB_N_LEARNED**h]j)}(hj|h]hIFLA_BR_FDB_N_LEARNED}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjvubjO)}(hhh]h)}(hPThe number of dynamically learned FDB entries for the current bridge, read only.h]hPThe number of dynamically learned FDB entries for the current bridge, read only.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjvubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hj**IFLA_BR_FDB_MAX_LEARNED** Set the number of max dynamically learned FDB entries for the current bridge. h](j3)}(h**IFLA_BR_FDB_MAX_LEARNED**h]j)}(hjh]hIFLA_BR_FDB_MAX_LEARNED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hMSet the number of max dynamically learned FDB entries for the current bridge.h]hMSet the number of max dynamically learned FDB entries for the current bridge.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BR_STP_MODE** Set the STP mode for the bridge, which controls how the bridge selects between userspace and kernel STP. The valid values are documented below in the ``BR_STP_MODE_*`` constants. h](j3)}(h**IFLA_BR_STP_MODE**h]j)}(hjh]hIFLA_BR_STP_MODE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hSet the STP mode for the bridge, which controls how the bridge selects between userspace and kernel STP. The valid values are documented below in the ``BR_STP_MODE_*`` constants.h](hSet the STP mode for the bridge, which controls how the bridge selects between userspace and kernel STP. The valid values are documented below in the }(hj hhhNhNubj9)}(h``BR_STP_MODE_*``h]h BR_STP_MODE_*}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj ubh constants.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:35: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubeh}(h]h ]h"]h$]h&]uh1j'hjxhhhNhNubeh}(h]bridge-netlink-attributesah ]h"]bridge netlink attributesah$]h&]uh1hhjYhhhhhK!ubh)}(hhh](h)}(hBridge port netlink attributesh]hBridge port netlink attributes}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhhhhhK'ubj()}(hhh](j-)}(hX**IFLA_BRPORT_STATE** The operation state of the port. Here are the valid values. * 0 - port is in STP *DISABLED* state. Make this port completely inactive for STP. This is also called BPDU filter and could be used to disable STP on an untrusted port, like a leaf virtual device. The traffic forwarding is also stopped on this port. * 1 - port is in STP *LISTENING* state. Only valid if STP is enabled on the bridge. In this state the port listens for STP BPDUs and drops all other traffic frames. * 2 - port is in STP *LEARNING* state. Only valid if STP is enabled on the bridge. In this state the port will accept traffic only for the purpose of updating MAC address tables. * 3 - port is in STP *FORWARDING* state. Port is fully active. * 4 - port is in STP *BLOCKING* state. Only valid if STP is enabled on the bridge. This state is used during the STP election process. In this state, port will only process STP BPDUs. h](j3)}(h**IFLA_BRPORT_STATE**h]j)}(hj^h]hIFLA_BRPORT_STATE}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMqhjXubjO)}(hhh](h)}(h;The operation state of the port. Here are the valid values.h]h;The operation state of the port. Here are the valid values.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMbhjtubj)}(hX\* 0 - port is in STP *DISABLED* state. Make this port completely inactive for STP. This is also called BPDU filter and could be used to disable STP on an untrusted port, like a leaf virtual device. The traffic forwarding is also stopped on this port. * 1 - port is in STP *LISTENING* state. Only valid if STP is enabled on the bridge. In this state the port listens for STP BPDUs and drops all other traffic frames. * 2 - port is in STP *LEARNING* state. Only valid if STP is enabled on the bridge. In this state the port will accept traffic only for the purpose of updating MAC address tables. * 3 - port is in STP *FORWARDING* state. Port is fully active. * 4 - port is in STP *BLOCKING* state. Only valid if STP is enabled on the bridge. This state is used during the STP election process. In this state, port will only process STP BPDUs. h]j)}(hhh](j)}(h0 - port is in STP *DISABLED* state. Make this port completely inactive for STP. This is also called BPDU filter and could be used to disable STP on an untrusted port, like a leaf virtual device. The traffic forwarding is also stopped on this port.h]h)}(h0 - port is in STP *DISABLED* state. Make this port completely inactive for STP. This is also called BPDU filter and could be used to disable STP on an untrusted port, like a leaf virtual device. The traffic forwarding is also stopped on this port.h](h0 - port is in STP }(hjhhhNhNubj )}(h *DISABLED*h]hDISABLED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh state. Make this port completely inactive for STP. This is also called BPDU filter and could be used to disable STP on an untrusted port, like a leaf virtual device. The traffic forwarding is also stopped on this port.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h1 - port is in STP *LISTENING* state. Only valid if STP is enabled on the bridge. In this state the port listens for STP BPDUs and drops all other traffic frames.h]h)}(h1 - port is in STP *LISTENING* state. Only valid if STP is enabled on the bridge. In this state the port listens for STP BPDUs and drops all other traffic frames.h](h1 - port is in STP }(hjhhhNhNubj )}(h *LISTENING*h]h LISTENING}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh state. Only valid if STP is enabled on the bridge. In this state the port listens for STP BPDUs and drops all other traffic frames.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h2 - port is in STP *LEARNING* state. Only valid if STP is enabled on the bridge. In this state the port will accept traffic only for the purpose of updating MAC address tables.h]h)}(h2 - port is in STP *LEARNING* state. Only valid if STP is enabled on the bridge. In this state the port will accept traffic only for the purpose of updating MAC address tables.h](h2 - port is in STP }(hjhhhNhNubj )}(h *LEARNING*h]hLEARNING}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh state. Only valid if STP is enabled on the bridge. In this state the port will accept traffic only for the purpose of updating MAC address tables.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMkhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h<3 - port is in STP *FORWARDING* state. Port is fully active.h]h)}(hjh](h3 - port is in STP }(hjhhhNhNubj )}(h *FORWARDING*h]h FORWARDING}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh state. Port is fully active.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMnhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h4 - port is in STP *BLOCKING* state. Only valid if STP is enabled on the bridge. This state is used during the STP election process. In this state, port will only process STP BPDUs. h]h)}(h4 - port is in STP *BLOCKING* state. Only valid if STP is enabled on the bridge. This state is used during the STP election process. In this state, port will only process STP BPDUs.h](h4 - port is in STP }(hj<hhhNhNubj )}(h *BLOCKING*h]hBLOCKING}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubh state. Only valid if STP is enabled on the bridge. This state is used during the STP election process. In this state, port will only process STP BPDUs.}(hj<hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMohj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjhMdhjtubeh}(h]h ]h"]h$]h&]uh1jNhjXubeh}(h]h ]h"]h$]h&]uh1j,hjshMqhjUubj-)}(hX**IFLA_BRPORT_PRIORITY** The STP port priority. The valid values are between 0 and 255. h](j3)}(h**IFLA_BRPORT_PRIORITY**h]j)}(hjh]hIFLA_BRPORT_PRIORITY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMthj{ubjO)}(hhh]h)}(h>The STP port priority. The valid values are between 0 and 255.h]h>The STP port priority. The valid values are between 0 and 255.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMthjubah}(h]h ]h"]h$]h&]uh1jNhj{ubeh}(h]h ]h"]h$]h&]uh1j,hjhMthjUubj-)}(h^**IFLA_BRPORT_COST** The STP path cost of the port. The valid values are between 1 and 65535. h](j3)}(h**IFLA_BRPORT_COST**h]j)}(hjh]hIFLA_BRPORT_COST}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMwhjubjO)}(hhh]h)}(hHThe STP path cost of the port. The valid values are between 1 and 65535.h]hHThe STP path cost of the port. The valid values are between 1 and 65535.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMwhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMwhjUubj-)}(h[**IFLA_BRPORT_MODE** Set the bridge port mode. See *BRIDGE_MODE_HAIRPIN* for more details. h](j3)}(h**IFLA_BRPORT_MODE**h]j)}(hjh]hIFLA_BRPORT_MODE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMzhjubjO)}(hhh]h)}(hESet the bridge port mode. See *BRIDGE_MODE_HAIRPIN* for more details.h](hSet the bridge port mode. See }(hj hhhNhNubj )}(h*BRIDGE_MODE_HAIRPIN*h]hBRIDGE_MODE_HAIRPIN}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh for more details.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMzhj ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMzhjUubj-)}(hX**IFLA_BRPORT_GUARD** Controls whether STP BPDUs will be processed by the bridge port. By default, the flag is turned off to allow BPDU processing. Turning this flag on will disable the bridge port if a STP BPDU packet is received. If the bridge has Spanning Tree enabled, hostile devices on the network may send BPDU on a port and cause network failure. Setting *guard on* will detect and stop this by disabling the port. The port will be restarted if the link is brought down, or removed and reattached. h](j3)}(h**IFLA_BRPORT_GUARD**h]j)}(hj>h]hIFLA_BRPORT_GUARD}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj8ubjO)}(hhh](h)}(hControls whether STP BPDUs will be processed by the bridge port. By default, the flag is turned off to allow BPDU processing. Turning this flag on will disable the bridge port if a STP BPDU packet is received.h]hControls whether STP BPDUs will be processed by the bridge port. By default, the flag is turned off to allow BPDU processing. Turning this flag on will disable the bridge port if a STP BPDU packet is received.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM}hjTubh)}(hXIf the bridge has Spanning Tree enabled, hostile devices on the network may send BPDU on a port and cause network failure. Setting *guard on* will detect and stop this by disabling the port. The port will be restarted if the link is brought down, or removed and reattached.h](hIf the bridge has Spanning Tree enabled, hostile devices on the network may send BPDU on a port and cause network failure. Setting }(hjfhhhNhNubj )}(h *guard on*h]hguard on}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubh will detect and stop this by disabling the port. The port will be restarted if the link is brought down, or removed and reattached.}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjTubeh}(h]h ]h"]h$]h&]uh1jNhj8ubeh}(h]h ]h"]h$]h&]uh1j,hjShMhjUubj-)}(hX**IFLA_BRPORT_PROTECT** Controls whether a given port is allowed to become a root port or not. Only used when STP is enabled on the bridge. By default the flag is off. This feature is also called root port guard. If BPDU is received from a leaf (edge) port, it should not be elected as root port. This could be used if using STP on a bridge and the downstream bridges are not fully trusted; this prevents a hostile guest from rerouting traffic. h](j3)}(h**IFLA_BRPORT_PROTECT**h]j)}(hjh]hIFLA_BRPORT_PROTECT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hControls whether a given port is allowed to become a root port or not. Only used when STP is enabled on the bridge. By default the flag is off.h]hControls whether a given port is allowed to become a root port or not. Only used when STP is enabled on the bridge. By default the flag is off.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubh)}(hXThis feature is also called root port guard. If BPDU is received from a leaf (edge) port, it should not be elected as root port. This could be used if using STP on a bridge and the downstream bridges are not fully trusted; this prevents a hostile guest from rerouting traffic.h]hXThis feature is also called root port guard. If BPDU is received from a leaf (edge) port, it should not be elected as root port. This could be used if using STP on a bridge and the downstream bridges are not fully trusted; this prevents a hostile guest from rerouting traffic.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjUubj-)}(h**IFLA_BRPORT_FAST_LEAVE** This flag allows the bridge to immediately stop multicast traffic forwarding on a port that receives an IGMP Leave message. It is only used when IGMP snooping is enabled on the bridge. By default the flag is off. h](j3)}(h**IFLA_BRPORT_FAST_LEAVE**h]j)}(hjh]hIFLA_BRPORT_FAST_LEAVE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hThis flag allows the bridge to immediately stop multicast traffic forwarding on a port that receives an IGMP Leave message. It is only used when IGMP snooping is enabled on the bridge. By default the flag is off.h]hThis flag allows the bridge to immediately stop multicast traffic forwarding on a port that receives an IGMP Leave message. It is only used when IGMP snooping is enabled on the bridge. By default the flag is off.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjUubj-)}(hX **IFLA_BRPORT_LEARNING** Controls whether a given port will learn *source* MAC addresses from received traffic or not. Also controls whether dynamic FDB entries (which can also be added by software) will be refreshed by incoming traffic. By default this flag is on. h](j3)}(h**IFLA_BRPORT_LEARNING**h]j)}(hjh]hIFLA_BRPORT_LEARNING}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hControls whether a given port will learn *source* MAC addresses from received traffic or not. Also controls whether dynamic FDB entries (which can also be added by software) will be refreshed by incoming traffic. By default this flag is on.h](h)Controls whether a given port will learn }(hj5hhhNhNubj )}(h*source*h]hsource}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh MAC addresses from received traffic or not. Also controls whether dynamic FDB entries (which can also be added by software) will be refreshed by incoming traffic. By default this flag is on.}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj2ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj1hMhjUubj-)}(h**IFLA_BRPORT_UNICAST_FLOOD** Controls whether unicast traffic for which there is no FDB entry will be flooded towards this port. By default this flag is on. h](j3)}(h**IFLA_BRPORT_UNICAST_FLOOD**h]j)}(hjhh]hIFLA_BRPORT_UNICAST_FLOOD}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjbubjO)}(hhh]h)}(hControls whether unicast traffic for which there is no FDB entry will be flooded towards this port. By default this flag is on.h]hControls whether unicast traffic for which there is no FDB entry will be flooded towards this port. By default this flag is on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj~ubah}(h]h ]h"]h$]h&]uh1jNhjbubeh}(h]h ]h"]h$]h&]uh1j,hj}hMhjUubj-)}(h8**IFLA_BRPORT_PROXYARP** Enable proxy ARP on this port. h](j3)}(h**IFLA_BRPORT_PROXYARP**h]j)}(hjh]hIFLA_BRPORT_PROXYARP}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hEnable proxy ARP on this port.h]hEnable proxy ARP on this port.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjUubj-)}(hz**IFLA_BRPORT_LEARNING_SYNC** Controls whether a given port will sync MAC addresses learned on device port to bridge FDB. h](j3)}(h**IFLA_BRPORT_LEARNING_SYNC**h]j)}(hjh]hIFLA_BRPORT_LEARNING_SYNC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(h[Controls whether a given port will sync MAC addresses learned on device port to bridge FDB.h]h[Controls whether a given port will sync MAC addresses learned on device port to bridge FDB.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjUubj-)}(h**IFLA_BRPORT_PROXYARP_WIFI** Enable proxy ARP on this port which meets extended requirements by IEEE 802.11 and Hotspot 2.0 specifications. h](j3)}(h**IFLA_BRPORT_PROXYARP_WIFI**h]j)}(hjh]hIFLA_BRPORT_PROXYARP_WIFI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hnEnable proxy ARP on this port which meets extended requirements by IEEE 802.11 and Hotspot 2.0 specifications.h]hnEnable proxy ARP on this port which meets extended requirements by IEEE 802.11 and Hotspot 2.0 specifications.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj+ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj*hMhjUubeh}(h]h ]h"]h$]h&]uh1j'hjDhhhNhNubh)}(h**IFLA_BRPORT_ROOT_ID**h]j)}(hjQh]hIFLA_BRPORT_ROOT_ID}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h**IFLA_BRPORT_BRIDGE_ID**h]j)}(hjih]hIFLA_BRPORT_BRIDGE_ID}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h**IFLA_BRPORT_DESIGNATED_PORT**h]j)}(hjh]hIFLA_BRPORT_DESIGNATED_PORT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h**IFLA_BRPORT_DESIGNATED_COST**h]j)}(hjh]hIFLA_BRPORT_DESIGNATED_COST}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h**IFLA_BRPORT_ID**h]j)}(hjh]hIFLA_BRPORT_ID}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h**IFLA_BRPORT_NO**h]j)}(hjh]hIFLA_BRPORT_NO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h#**IFLA_BRPORT_TOPOLOGY_CHANGE_ACK**h]j)}(hjh]hIFLA_BRPORT_TOPOLOGY_CHANGE_ACK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h**IFLA_BRPORT_CONFIG_PENDING**h]j)}(hjh]hIFLA_BRPORT_CONFIG_PENDING}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h!**IFLA_BRPORT_MESSAGE_AGE_TIMER**h]j)}(hjh]hIFLA_BRPORT_MESSAGE_AGE_TIMER}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h#**IFLA_BRPORT_FORWARD_DELAY_TIMER**h]j)}(hj)h]hIFLA_BRPORT_FORWARD_DELAY_TIMER}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubh)}(h**IFLA_BRPORT_HOLD_TIMER**h]j)}(hjAh]hIFLA_BRPORT_HOLD_TIMER}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubj()}(hhh](j-)}(h?**IFLA_BRPORT_FLUSH** Flush bridge ports' fdb dynamic entries. h](j3)}(h**IFLA_BRPORT_FLUSH**h]j)}(hj`h]hIFLA_BRPORT_FLUSH}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjZubjO)}(hhh]h)}(h(Flush bridge ports' fdb dynamic entries.h]h*Flush bridge ports’ fdb dynamic entries.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMhjvubah}(h]h ]h"]h$]h&]uh1jNhjZubeh}(h]h ]h"]h$]h&]uh1j,hjuhMhjWubj-)}(hX**IFLA_BRPORT_MULTICAST_ROUTER** Configure the port's multicast router presence. A port with a multicast router will receive all multicast traffic. The valid values are: * 0 disable multicast routers on this port * 1 let the system detect the presence of routers (default) * 2 permanently enable multicast traffic forwarding on this port * 3 enable multicast routers temporarily on this port, not depending on incoming queries. h](j3)}(h **IFLA_BRPORT_MULTICAST_ROUTER**h]j)}(hjh]hIFLA_BRPORT_MULTICAST_ROUTER}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(hConfigure the port's multicast router presence. A port with a multicast router will receive all multicast traffic. The valid values are:h]hConfigure the port’s multicast router presence. A port with a multicast router will receive all multicast traffic. The valid values are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubj)}(hX* 0 disable multicast routers on this port * 1 let the system detect the presence of routers (default) * 2 permanently enable multicast traffic forwarding on this port * 3 enable multicast routers temporarily on this port, not depending on incoming queries. h]j)}(hhh](j)}(h(0 disable multicast routers on this porth]h)}(hjh]h(0 disable multicast routers on this port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h91 let the system detect the presence of routers (default)h]h)}(hjh]h91 let the system detect the presence of routers (default)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h>2 permanently enable multicast traffic forwarding on this porth]h)}(hjh]h>2 permanently enable multicast traffic forwarding on this port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hZ3 enable multicast routers temporarily on this port, not depending on incoming queries. h]j()}(hhh]j-)}(hX3 enable multicast routers temporarily on this port, not depending on incoming queries. h](j3)}(hB3 enable multicast routers temporarily on this port, not dependingh]hB3 enable multicast routers temporarily on this port, not depending}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjhMhjubjO)}(hhh]h)}(hon incoming queries.h]hon incoming queries.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhj)ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubah}(h]h ]h"]h$]h&]uh1j'hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjWubeh}(h]h ]h"]h$]h&]uh1j'hjDhhhNhNubh)}(h**IFLA_BRPORT_PAD**h]j)}(hjrh]hIFLA_BRPORT_PAD}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjDhhubj()}(hhh](j-)}(h**IFLA_BRPORT_MCAST_FLOOD** Controls whether a given port will flood multicast traffic for which there is no MDB entry. By default this flag is on. h](j3)}(h**IFLA_BRPORT_MCAST_FLOOD**h]j)}(hjh]hIFLA_BRPORT_MCAST_FLOOD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hwControls whether a given port will flood multicast traffic for which there is no MDB entry. By default this flag is on.h]hwControls whether a given port will flood multicast traffic for which there is no MDB entry. By default this flag is on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hX**IFLA_BRPORT_MCAST_TO_UCAST** Controls whether a given port will replicate packets using unicast instead of multicast. By default this flag is off. This is done by copying the packet per host and changing the multicast destination MAC to a unicast one accordingly. *mcast_to_unicast* works on top of the multicast snooping feature of the bridge. Which means unicast copies are only delivered to hosts which are interested in unicast and signaled this via IGMP/MLD reports previously. This feature is intended for interface types which have a more reliable and/or efficient way to deliver unicast packets than broadcast ones (e.g. WiFi). However, it should only be enabled on interfaces where no IGMPv2/MLDv1 report suppression takes place. IGMP/MLD report suppression issue is usually overcome by the network daemon (supplicant) enabling AP isolation and by that separating all STAs. Delivery of STA-to-STA IP multicast is made possible again by enabling and utilizing the bridge hairpin mode, which considers the incoming port as a potential outgoing port, too (see *BRIDGE_MODE_HAIRPIN* option). Hairpin mode is performed after multicast snooping, therefore leading to only deliver reports to STAs running a multicast router. h](j3)}(h**IFLA_BRPORT_MCAST_TO_UCAST**h]j)}(hjh]hIFLA_BRPORT_MCAST_TO_UCAST}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh](h)}(huControls whether a given port will replicate packets using unicast instead of multicast. By default this flag is off.h]huControls whether a given port will replicate packets using unicast instead of multicast. By default this flag is off.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubh)}(htThis is done by copying the packet per host and changing the multicast destination MAC to a unicast one accordingly.h]htThis is done by copying the packet per host and changing the multicast destination MAC to a unicast one accordingly.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubh)}(h*mcast_to_unicast* works on top of the multicast snooping feature of the bridge. Which means unicast copies are only delivered to hosts which are interested in unicast and signaled this via IGMP/MLD reports previously.h](j )}(h*mcast_to_unicast*h]hmcast_to_unicast}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh works on top of the multicast snooping feature of the bridge. Which means unicast copies are only delivered to hosts which are interested in unicast and signaled this via IGMP/MLD reports previously.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubh)}(hThis feature is intended for interface types which have a more reliable and/or efficient way to deliver unicast packets than broadcast ones (e.g. WiFi).h]hThis feature is intended for interface types which have a more reliable and/or efficient way to deliver unicast packets than broadcast ones (e.g. WiFi).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubh)}(hHowever, it should only be enabled on interfaces where no IGMPv2/MLDv1 report suppression takes place. IGMP/MLD report suppression issue is usually overcome by the network daemon (supplicant) enabling AP isolation and by that separating all STAs.h]hHowever, it should only be enabled on interfaces where no IGMPv2/MLDv1 report suppression takes place. IGMP/MLD report suppression issue is usually overcome by the network daemon (supplicant) enabling AP isolation and by that separating all STAs.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubh)}(hXWDelivery of STA-to-STA IP multicast is made possible again by enabling and utilizing the bridge hairpin mode, which considers the incoming port as a potential outgoing port, too (see *BRIDGE_MODE_HAIRPIN* option). Hairpin mode is performed after multicast snooping, therefore leading to only deliver reports to STAs running a multicast router.h](hDelivery of STA-to-STA IP multicast is made possible again by enabling and utilizing the bridge hairpin mode, which considers the incoming port as a potential outgoing port, too (see }(hj=hhhNhNubj )}(h*BRIDGE_MODE_HAIRPIN*h]hBRIDGE_MODE_HAIRPIN}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubh option). Hairpin mode is performed after multicast snooping, therefore leading to only deliver reports to STAs running a multicast router.}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubeh}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hy**IFLA_BRPORT_VLAN_TUNNEL** Controls whether vlan to tunnel mapping is enabled on the port. By default this flag is off. h](j3)}(h**IFLA_BRPORT_VLAN_TUNNEL**h]j)}(hjph]hIFLA_BRPORT_VLAN_TUNNEL}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjjubjO)}(hhh]h)}(h\Controls whether vlan to tunnel mapping is enabled on the port. By default this flag is off.h]h\Controls whether vlan to tunnel mapping is enabled on the port. By default this flag is off.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hr**IFLA_BRPORT_BCAST_FLOOD** Controls flooding of broadcast traffic on the given port. By default this flag is on. h](j3)}(h**IFLA_BRPORT_BCAST_FLOOD**h]j)}(hjh]hIFLA_BRPORT_BCAST_FLOOD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hUControls flooding of broadcast traffic on the given port. By default this flag is on.h]hUControls flooding of broadcast traffic on the given port. By default this flag is on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(hX@**IFLA_BRPORT_GROUP_FWD_MASK** Set the group forward mask. This is a bitmask that is applied to decide whether to forward incoming frames destined to link-local addresses. The addresses of the form are 01:80:C2:00:00:0X (defaults to 0, which means the bridge does not forward any link-local frames coming on this port). h](j3)}(h**IFLA_BRPORT_GROUP_FWD_MASK**h]j)}(hjh]hIFLA_BRPORT_GROUP_FWD_MASK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hX Set the group forward mask. This is a bitmask that is applied to decide whether to forward incoming frames destined to link-local addresses. The addresses of the form are 01:80:C2:00:00:0X (defaults to 0, which means the bridge does not forward any link-local frames coming on this port).h]hX Set the group forward mask. This is a bitmask that is applied to decide whether to forward incoming frames destined to link-local addresses. The addresses of the form are 01:80:C2:00:00:0X (defaults to 0, which means the bridge does not forward any link-local frames coming on this port).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubj-)}(h**IFLA_BRPORT_NEIGH_SUPPRESS** Controls whether neighbor discovery (arp and nd) proxy and suppression is enabled on the port. By default this flag is off. h](j3)}(h**IFLA_BRPORT_NEIGH_SUPPRESS**h]j)}(hjh]hIFLA_BRPORT_NEIGH_SUPPRESS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(h{Controls whether neighbor discovery (arp and nd) proxy and suppression is enabled on the port. By default this flag is off.h]h{Controls whether neighbor discovery (arp and nd) proxy and suppression is enabled on the port. By default this flag is off.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj4ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj3hMhjubj-)}(h**IFLA_BRPORT_ISOLATED** Controls whether a given port will be isolated, which means it will be able to communicate with non-isolated ports only. By default this flag is off. h](j3)}(h**IFLA_BRPORT_ISOLATED**h]j)}(hjXh]hIFLA_BRPORT_ISOLATED}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjRubjO)}(hhh]h)}(hControls whether a given port will be isolated, which means it will be able to communicate with non-isolated ports only. By default this flag is off.h]hControls whether a given port will be isolated, which means it will be able to communicate with non-isolated ports only. By default this flag is off.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjnubah}(h]h ]h"]h$]h&]uh1jNhjRubeh}(h]h ]h"]h$]h&]uh1j,hjmhMhjubj-)}(h**IFLA_BRPORT_BACKUP_PORT** Set a backup port. If the port loses carrier all traffic will be redirected to the configured backup port. Set the value to 0 to disable it. h](j3)}(h**IFLA_BRPORT_BACKUP_PORT**h]j)}(hjh]hIFLA_BRPORT_BACKUP_PORT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(hSet a backup port. If the port loses carrier all traffic will be redirected to the configured backup port. Set the value to 0 to disable it.h]hSet a backup port. If the port loses carrier all traffic will be redirected to the configured backup port. Set the value to 0 to disable it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hjhMhjubeh}(h]h ]h"]h$]h&]uh1j'hjDhhhNhNubh)}(h**IFLA_BRPORT_MRP_RING_OPEN**h]j)}(hjh]hIFLA_BRPORT_MRP_RING_OPEN}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM hjDhhubh)}(h**IFLA_BRPORT_MRP_IN_OPEN**h]j)}(hjh]hIFLA_BRPORT_MRP_IN_OPEN}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM hjDhhubj()}(hhh](j-)}(h**IFLA_BRPORT_MCAST_EHT_HOSTS_LIMIT** The number of per-port EHT hosts limit. The default value is 512. Setting to 0 is not allowed. h](j3)}(h%**IFLA_BRPORT_MCAST_EHT_HOSTS_LIMIT**h]j)}(hj h]h!IFLA_BRPORT_MCAST_EHT_HOSTS_LIMIT}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjubjO)}(hhh]h)}(h^The number of per-port EHT hosts limit. The default value is 512. Setting to 0 is not allowed.h]h^The number of per-port EHT hosts limit. The default value is 512. Setting to 0 is not allowed.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj ubah}(h]h ]h"]h$]h&]uh1jNhjubeh}(h]h ]h"]h$]h&]uh1j,hj hMhjubj-)}(hT**IFLA_BRPORT_MCAST_EHT_HOSTS_CNT** The current number of tracked hosts, read only. h](j3)}(h#**IFLA_BRPORT_MCAST_EHT_HOSTS_CNT**h]j)}(hj? h]hIFLA_BRPORT_MCAST_EHT_HOSTS_CNT}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj= ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj9 ubjO)}(hhh]h)}(h/The current number of tracked hosts, read only.h]h/The current number of tracked hosts, read only.}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjT hMhjU ubah}(h]h ]h"]h$]h&]uh1jNhj9 ubeh}(h]h ]h"]h$]h&]uh1j,hjT hMhjubj-)}(hX9**IFLA_BRPORT_LOCKED** Controls whether a port will be locked, meaning that hosts behind the port will not be able to communicate through the port unless an FDB entry with the unit's MAC address is in the FDB. The common use case is that hosts are allowed access through authentication with the IEEE 802.1X protocol or based on whitelists. By default this flag is off. Please note that secure 802.1X deployments should always use the *BR_BOOLOPT_NO_LL_LEARN* flag, to not permit the bridge to populate its FDB based on link-local (EAPOL) traffic received on the port. h](j3)}(h**IFLA_BRPORT_LOCKED**h]j)}(hjx h]hIFLA_BRPORT_LOCKED}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjv ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhjr ubjO)}(hhh](h)}(hXYControls whether a port will be locked, meaning that hosts behind the port will not be able to communicate through the port unless an FDB entry with the unit's MAC address is in the FDB. The common use case is that hosts are allowed access through authentication with the IEEE 802.1X protocol or based on whitelists. By default this flag is off.h]hX[Controls whether a port will be locked, meaning that hosts behind the port will not be able to communicate through the port unless an FDB entry with the unit’s MAC address is in the FDB. The common use case is that hosts are allowed access through authentication with the IEEE 802.1X protocol or based on whitelists. By default this flag is off.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj ubh)}(hPlease note that secure 802.1X deployments should always use the *BR_BOOLOPT_NO_LL_LEARN* flag, to not permit the bridge to populate its FDB based on link-local (EAPOL) traffic received on the port.h](hAPlease note that secure 802.1X deployments should always use the }(hj hhhNhNubj )}(h*BR_BOOLOPT_NO_LL_LEARN*h]hBR_BOOLOPT_NO_LL_LEARN}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhm flag, to not permit the bridge to populate its FDB based on link-local (EAPOL) traffic received on the port.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMhj ubeh}(h]h ]h"]h$]h&]uh1jNhjr ubeh}(h]h ]h"]h$]h&]uh1j,hj hMhjubj-)}(hX5**IFLA_BRPORT_MAB** Controls whether a port will use MAC Authentication Bypass (MAB), a technique through which select MAC addresses may be allowed on a locked port, without using 802.1X authentication. Packets with an unknown source MAC address generates a "locked" FDB entry on the incoming bridge port. The common use case is for user space to react to these bridge FDB notifications and optionally replace the locked FDB entry with a normal one, allowing traffic to pass for whitelisted MAC addresses. Setting this flag also requires *IFLA_BRPORT_LOCKED* and *IFLA_BRPORT_LEARNING*. *IFLA_BRPORT_LOCKED* ensures that unauthorized data packets are dropped, and *IFLA_BRPORT_LEARNING* allows the dynamic FDB entries installed by user space (as replacements for the locked FDB entries) to be refreshed and/or aged out. h](j3)}(h**IFLA_BRPORT_MAB**h]j)}(hj h]hIFLA_BRPORT_MAB}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM-hj ubjO)}(hhh](h)}(hXControls whether a port will use MAC Authentication Bypass (MAB), a technique through which select MAC addresses may be allowed on a locked port, without using 802.1X authentication. Packets with an unknown source MAC address generates a "locked" FDB entry on the incoming bridge port. The common use case is for user space to react to these bridge FDB notifications and optionally replace the locked FDB entry with a normal one, allowing traffic to pass for whitelisted MAC addresses.h]hXControls whether a port will use MAC Authentication Bypass (MAB), a technique through which select MAC addresses may be allowed on a locked port, without using 802.1X authentication. Packets with an unknown source MAC address generates a “locked” FDB entry on the incoming bridge port. The common use case is for user space to react to these bridge FDB notifications and optionally replace the locked FDB entry with a normal one, allowing traffic to pass for whitelisted MAC addresses.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM!hj ubh)}(hX9Setting this flag also requires *IFLA_BRPORT_LOCKED* and *IFLA_BRPORT_LEARNING*. *IFLA_BRPORT_LOCKED* ensures that unauthorized data packets are dropped, and *IFLA_BRPORT_LEARNING* allows the dynamic FDB entries installed by user space (as replacements for the locked FDB entries) to be refreshed and/or aged out.h](h Setting this flag also requires }(hj hhhNhNubj )}(h*IFLA_BRPORT_LOCKED*h]hIFLA_BRPORT_LOCKED}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh and }(hj hhhNhNubj )}(h*IFLA_BRPORT_LEARNING*h]hIFLA_BRPORT_LEARNING}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh. }(hj hhhNhNubj )}(h*IFLA_BRPORT_LOCKED*h]hIFLA_BRPORT_LOCKED}(hj'!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh9 ensures that unauthorized data packets are dropped, and }(hj hhhNhNubj )}(h*IFLA_BRPORT_LEARNING*h]hIFLA_BRPORT_LEARNING}(hj9!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh allows the dynamic FDB entries installed by user space (as replacements for the locked FDB entries) to be refreshed and/or aged out.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM)hj ubeh}(h]h ]h"]h$]h&]uh1jNhj ubeh}(h]h ]h"]h$]h&]uh1j,hj hM-hjubeh}(h]h ]h"]h$]h&]uh1j'hjDhhhNhNubh)}(h**IFLA_BRPORT_MCAST_N_GROUPS**h]j)}(hjf!h]hIFLA_BRPORT_MCAST_N_GROUPS}(hjh!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd!ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM/hjDhhubj()}(hhh](j-)}(hXn**IFLA_BRPORT_MCAST_MAX_GROUPS** Sets the maximum number of MDB entries that can be registered for a given port. Attempts to register more MDB entries at the port than this limit allows will be rejected, whether they are done through netlink (e.g. the bridge tool), or IGMP or MLD membership reports. Setting a limit of 0 disables the limit. The default value is 0. h](j3)}(h **IFLA_BRPORT_MCAST_MAX_GROUPS**h]j)}(hj!h]hIFLA_BRPORT_MCAST_MAX_GROUPS}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM6hj!ubjO)}(hhh]h)}(hXLSets the maximum number of MDB entries that can be registered for a given port. Attempts to register more MDB entries at the port than this limit allows will be rejected, whether they are done through netlink (e.g. the bridge tool), or IGMP or MLD membership reports. Setting a limit of 0 disables the limit. The default value is 0.h]hXLSets the maximum number of MDB entries that can be registered for a given port. Attempts to register more MDB entries at the port than this limit allows will be rejected, whether they are done through netlink (e.g. the bridge tool), or IGMP or MLD membership reports. Setting a limit of 0 disables the limit. The default value is 0.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM2hj!ubah}(h]h ]h"]h$]h&]uh1jNhj!ubeh}(h]h ]h"]h$]h&]uh1j,hj!hM6hj|!ubj-)}(hX **IFLA_BRPORT_NEIGH_VLAN_SUPPRESS** Controls whether neighbor discovery (arp and nd) proxy and suppression is enabled for a given port. By default this flag is off. Note that this option only takes effect when *IFLA_BRPORT_NEIGH_SUPPRESS* is enabled for a given port. h](j3)}(h#**IFLA_BRPORT_NEIGH_VLAN_SUPPRESS**h]j)}(hj!h]hIFLA_BRPORT_NEIGH_VLAN_SUPPRESS}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM=hj!ubjO)}(hhh](h)}(hControls whether neighbor discovery (arp and nd) proxy and suppression is enabled for a given port. By default this flag is off.h]hControls whether neighbor discovery (arp and nd) proxy and suppression is enabled for a given port. By default this flag is off.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM9hj!ubh)}(hfNote that this option only takes effect when *IFLA_BRPORT_NEIGH_SUPPRESS* is enabled for a given port.h](h-Note that this option only takes effect when }(hj!hhhNhNubj )}(h*IFLA_BRPORT_NEIGH_SUPPRESS*h]hIFLA_BRPORT_NEIGH_SUPPRESS}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubh is enabled for a given port.}(hj!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM<hj!ubeh}(h]h ]h"]h$]h&]uh1jNhj!ubeh}(h]h ]h"]h$]h&]uh1j,hj!hM=hj|!ubj-)}(hX **IFLA_BRPORT_NEIGH_FORWARD_GRAT** Controls whether gratuitous ARP packets and unsolicited Neighbor Advertisement packets are forwarded on a given port even when neighbor suppression is enabled. By default this flag is off, meaning gratuitous ARP and unsolicited NA packets will be suppressed when neighbor suppression is enabled. Setting this flag to on allows these packets to be forwarded even when *IFLA_BRPORT_NEIGH_SUPPRESS* or *IFLA_BRPORT_NEIGH_VLAN_SUPPRESS* is enabled. Note that this option only takes effect when *IFLA_BRPORT_NEIGH_SUPPRESS* or *IFLA_BRPORT_NEIGH_VLAN_SUPPRESS* is enabled for a given port. When *IFLA_BRPORT_NEIGH_VLAN_SUPPRESS* is set, this port-level flag is ignored and per-VLAN control is available via *BRIDGE_VLANDB_ENTRY_NEIGH_FORWARD_GRAT*. h](j3)}(h"**IFLA_BRPORT_NEIGH_FORWARD_GRAT**h]j)}(hj"h]hIFLA_BRPORT_NEIGH_FORWARD_GRAT}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMMhj"ubjO)}(hhh](h)}(hXControls whether gratuitous ARP packets and unsolicited Neighbor Advertisement packets are forwarded on a given port even when neighbor suppression is enabled. By default this flag is off, meaning gratuitous ARP and unsolicited NA packets will be suppressed when neighbor suppression is enabled. Setting this flag to on allows these packets to be forwarded even when *IFLA_BRPORT_NEIGH_SUPPRESS* or *IFLA_BRPORT_NEIGH_VLAN_SUPPRESS* is enabled.h](hXoControls whether gratuitous ARP packets and unsolicited Neighbor Advertisement packets are forwarded on a given port even when neighbor suppression is enabled. By default this flag is off, meaning gratuitous ARP and unsolicited NA packets will be suppressed when neighbor suppression is enabled. Setting this flag to on allows these packets to be forwarded even when }(hj3"hhhNhNubj )}(h*IFLA_BRPORT_NEIGH_SUPPRESS*h]hIFLA_BRPORT_NEIGH_SUPPRESS}(hj;"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3"ubh or }(hj3"hhhNhNubj )}(h!*IFLA_BRPORT_NEIGH_VLAN_SUPPRESS*h]hIFLA_BRPORT_NEIGH_VLAN_SUPPRESS}(hjM"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3"ubh is enabled.}(hj3"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhM@hj0"ubh)}(hX*Note that this option only takes effect when *IFLA_BRPORT_NEIGH_SUPPRESS* or *IFLA_BRPORT_NEIGH_VLAN_SUPPRESS* is enabled for a given port. When *IFLA_BRPORT_NEIGH_VLAN_SUPPRESS* is set, this port-level flag is ignored and per-VLAN control is available via *BRIDGE_VLANDB_ENTRY_NEIGH_FORWARD_GRAT*.h](h-Note that this option only takes effect when }(hjf"hhhNhNubj )}(h*IFLA_BRPORT_NEIGH_SUPPRESS*h]hIFLA_BRPORT_NEIGH_SUPPRESS}(hjn"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjf"ubh or }(hjf"hhhNhNubj )}(h!*IFLA_BRPORT_NEIGH_VLAN_SUPPRESS*h]hIFLA_BRPORT_NEIGH_VLAN_SUPPRESS}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjf"ubh# is enabled for a given port. When }(hjf"hhhNhNubj )}(h!*IFLA_BRPORT_NEIGH_VLAN_SUPPRESS*h]hIFLA_BRPORT_NEIGH_VLAN_SUPPRESS}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjf"ubhO is set, this port-level flag is ignored and per-VLAN control is available via }(hjf"hhhNhNubj )}(h(*BRIDGE_VLANDB_ENTRY_NEIGH_FORWARD_GRAT*h]h&BRIDGE_VLANDB_ENTRY_NEIGH_FORWARD_GRAT}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjf"ubh.}(hjf"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMIhj0"ubeh}(h]h ]h"]h$]h&]uh1jNhj"ubeh}(h]h ]h"]h$]h&]uh1j,hj/"hMMhj|!ubj-)}(hX**IFLA_BRPORT_BACKUP_NHID** The FDB nexthop object ID to attach to packets being redirected to a backup port that has VLAN tunnel mapping enabled (via the *IFLA_BRPORT_VLAN_TUNNEL* option). Setting a value of 0 (default) has the effect of not attaching any ID. h](j3)}(h**IFLA_BRPORT_BACKUP_NHID**h]j)}(hj"h]hIFLA_BRPORT_BACKUP_NHID}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1j2h^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMThj"ubjO)}(hhh]h)}(hThe FDB nexthop object ID to attach to packets being redirected to a backup port that has VLAN tunnel mapping enabled (via the *IFLA_BRPORT_VLAN_TUNNEL* option). Setting a value of 0 (default) has the effect of not attaching any ID.h](hThe FDB nexthop object ID to attach to packets being redirected to a backup port that has VLAN tunnel mapping enabled (via the }(hj"hhhNhNubj )}(h*IFLA_BRPORT_VLAN_TUNNEL*h]hIFLA_BRPORT_VLAN_TUNNEL}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubhP option). Setting a value of 0 (default) has the effect of not attaching any ID.}(hj"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/networking/bridge:41: ./include/uapi/linux/if_link.hhMPhj"ubah}(h]h ]h"]h$]h&]uh1jNhj"ubeh}(h]h ]h"]h$]h&]uh1j,hj"hMThj|!ubeh}(h]h ]h"]h$]h&]uh1j'hjDhhhNhNubeh}(h]bridge-port-netlink-attributesah ]h"]bridge port netlink attributesah$]h&]uh1hhjYhhhhhK'ubh)}(hhh](h)}(h Bridge sysfsh]h Bridge sysfs}(hj&#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj##hhhhhK-ubh)}(hVThe sysfs interface is deprecated and should not be extended if new options are added.h]hVThe sysfs interface is deprecated and should not be extended if new options are added.}(hj4#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj##hhubeh}(h] bridge-sysfsah ]h"] bridge sysfsah$]h&]uh1hhjYhhhhhK-ubeh}(h] bridge-uapiah ]h"] bridge uapiah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hSTPh]hSTP}(hjU#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjR#hhhhhK3ubh)}(hX#The STP (Spanning Tree Protocol) implementation in the Linux bridge driver is a critical feature that helps prevent loops and broadcast storms in Ethernet networks by identifying and disabling redundant links. In a Linux bridge context, STP is crucial for network stability and availability.h]hX#The STP (Spanning Tree Protocol) implementation in the Linux bridge driver is a critical feature that helps prevent loops and broadcast storms in Ethernet networks by identifying and disabling redundant links. In a Linux bridge context, STP is crucial for network stability and availability.}(hjc#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjR#hhubh)}(hXWSTP is a Layer 2 protocol that operates at the Data Link Layer of the OSI model. It was originally developed as IEEE 802.1D and has since evolved into multiple versions, including Rapid Spanning Tree Protocol (RSTP) and `Multiple Spanning Tree Protocol (MSTP) `_.h](hSTP is a Layer 2 protocol that operates at the Data Link Layer of the OSI model. It was originally developed as IEEE 802.1D and has since evolved into multiple versions, including Rapid Spanning Tree Protocol (RSTP) and }(hjq#hhhNhNubh reference)}(hz`Multiple Spanning Tree Protocol (MSTP) `_h]h&Multiple Spanning Tree Protocol (MSTP)}(hj{#hhhNhNubah}(h]h ]h"]h$]h&]name&Multiple Spanning Tree Protocol (MSTP)refuriNhttps://lore.kernel.org/netdev/20220316150857.2442916-1-tobias@waldekranz.com/uh1jy#hjq#ubhtarget)}(hQ h]h}(h]$multiple-spanning-tree-protocol-mstpah ]h"]&multiple spanning tree protocol (mstp)ah$]h&]refurij#uh1j# referencedKhjq#ubh.}(hjq#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK:hjR#hhubh)}(hXVThe 802.1D-2004 removed the original Spanning Tree Protocol, instead incorporating the Rapid Spanning Tree Protocol (RSTP). By 2014, all the functionality defined by IEEE 802.1D has been incorporated into either IEEE 802.1Q (Bridges and Bridged Networks) or IEEE 802.1AC (MAC Service Definition). 802.1D has been officially withdrawn in 2022.h]hXVThe 802.1D-2004 removed the original Spanning Tree Protocol, instead incorporating the Rapid Spanning Tree Protocol (RSTP). By 2014, all the functionality defined by IEEE 802.1D has been incorporated into either IEEE 802.1Q (Bridges and Bridged Networks) or IEEE 802.1AC (MAC Service Definition). 802.1D has been officially withdrawn in 2022.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjR#hhubh)}(hhh](h)}(hBridge Ports and STP Statesh]hBridge Ports and STP States}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hhhhhKGubj()}(hhh]j-)}(hXIn the context of STP, bridge ports can be in one of the following states: * Blocking: The port is disabled for data traffic and only listens for BPDUs (Bridge Protocol Data Units) from other devices to determine the network topology. * Listening: The port begins to participate in the STP process and listens for BPDUs. * Learning: The port continues to listen for BPDUs and begins to learn MAC addresses from incoming frames but does not forward data frames. * Forwarding: The port is fully operational and forwards both BPDUs and data frames. * Disabled: The port is administratively disabled and does not participate in the STP process. The data frames forwarding are also disabled. h](j3)}(hJIn the context of STP, bridge ports can be in one of the following states:h]hJIn the context of STP, bridge ports can be in one of the following states:}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hhhKThj#ubjO)}(hhh]j)}(hhh](j)}(hBlocking: The port is disabled for data traffic and only listens for BPDUs (Bridge Protocol Data Units) from other devices to determine the network topology.h]h)}(hBlocking: The port is disabled for data traffic and only listens for BPDUs (Bridge Protocol Data Units) from other devices to determine the network topology.h]hBlocking: The port is disabled for data traffic and only listens for BPDUs (Bridge Protocol Data Units) from other devices to determine the network topology.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubj)}(hSListening: The port begins to participate in the STP process and listens for BPDUs.h]h)}(hSListening: The port begins to participate in the STP process and listens for BPDUs.h]hSListening: The port begins to participate in the STP process and listens for BPDUs.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubj)}(hLearning: The port continues to listen for BPDUs and begins to learn MAC addresses from incoming frames but does not forward data frames.h]h)}(hLearning: The port continues to listen for BPDUs and begins to learn MAC addresses from incoming frames but does not forward data frames.h]hLearning: The port continues to listen for BPDUs and begins to learn MAC addresses from incoming frames but does not forward data frames.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhj$ubah}(h]h ]h"]h$]h&]uh1jhj#ubj)}(hRForwarding: The port is fully operational and forwards both BPDUs and data frames.h]h)}(hRForwarding: The port is fully operational and forwards both BPDUs and data frames.h]hRForwarding: The port is fully operational and forwards both BPDUs and data frames.}(hj-$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhj)$ubah}(h]h ]h"]h$]h&]uh1jhj#ubj)}(hDisabled: The port is administratively disabled and does not participate in the STP process. The data frames forwarding are also disabled. h]h)}(hDisabled: The port is administratively disabled and does not participate in the STP process. The data frames forwarding are also disabled.h]hDisabled: The port is administratively disabled and does not participate in the STP process. The data frames forwarding are also disabled.}(hjE$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShjA$ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]jjuh1jhhhKJhj#ubah}(h]h ]h"]h$]h&]uh1jNhj#ubeh}(h]h ]h"]h$]h&]uh1j,hhhKThj#ubah}(h]h ]h"]h$]h&]uh1j'hj#hhhNhNubeh}(h]bridge-ports-and-stp-statesah ]h"]bridge ports and stp statesah$]h&]uh1hhjR#hhhhhKGubh)}(hhh](h)}(hRoot Bridge and Convergenceh]hRoot Bridge and Convergence}(hj|$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjy$hhhhhKWubh)}(hIn the context of networking and Ethernet bridging in Linux, the root bridge is a designated switch in a bridged network that serves as a reference point for the spanning tree algorithm to create a loop-free topology.h]hIn the context of networking and Ethernet bridging in Linux, the root bridge is a designated switch in a bridged network that serves as a reference point for the spanning tree algorithm to create a loop-free topology.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjy$hhubj()}(hhh]j-)}(hX Here's how the STP works and root bridge is chosen: 1. Bridge Priority: Each bridge running a spanning tree protocol, has a configurable Bridge Priority value. The lower the value, the higher the priority. By default, the Bridge Priority is set to a standard value (e.g., 32768). 2. Bridge ID: The Bridge ID is composed of two components: Bridge Priority and the MAC address of the bridge. It uniquely identifies each bridge in the network. The Bridge ID is used to compare the priorities of different bridges. 3. Bridge Election: When the network starts, all bridges initially assume that they are the root bridge. They start advertising Bridge Protocol Data Units (BPDU) to their neighbors, containing their Bridge ID and other information. 4. BPDU Comparison: Bridges exchange BPDUs to determine the root bridge. Each bridge examines the received BPDUs, including the Bridge Priority and Bridge ID, to determine if it should adjust its own priorities. The bridge with the lowest Bridge ID will become the root bridge. 5. Root Bridge Announcement: Once the root bridge is determined, it sends BPDUs with information about the root bridge to all other bridges in the network. This information is used by other bridges to calculate the shortest path to the root bridge and, in doing so, create a loop-free topology. 6. Forwarding Ports: After the root bridge is selected and the spanning tree topology is established, each bridge determines which of its ports should be in the forwarding state (used for data traffic) and which should be in the blocking state (used to prevent loops). The root bridge's ports are all in the forwarding state. while other bridges have some ports in the blocking state to avoid loops. 7. Root Ports: After the root bridge is selected and the spanning tree topology is established, each non-root bridge processes incoming BPDUs and determines which of its ports provides the shortest path to the root bridge based on the information in the received BPDUs. This port is designated as the root port. And it is in the Forwarding state, allowing it to actively forward network traffic. 8. Designated ports: A designated port is the port through which the non-root bridge will forward traffic towards the designated segment. Designated ports are placed in the Forwarding state. All other ports on the non-root bridge that are not designated for specific segments are placed in the Blocking state to prevent network loops. h](j3)}(h3Here's how the STP works and root bridge is chosen:h]h5Here’s how the STP works and root bridge is chosen:}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hhhKhj$ubjO)}(hhh]henumerated_list)}(hhh](j)}(hBridge Priority: Each bridge running a spanning tree protocol, has a configurable Bridge Priority value. The lower the value, the higher the priority. By default, the Bridge Priority is set to a standard value (e.g., 32768).h]h)}(hBridge Priority: Each bridge running a spanning tree protocol, has a configurable Bridge Priority value. The lower the value, the higher the priority. By default, the Bridge Priority is set to a standard value (e.g., 32768).h]hBridge Priority: Each bridge running a spanning tree protocol, has a configurable Bridge Priority value. The lower the value, the higher the priority. By default, the Bridge Priority is set to a standard value (e.g., 32768).}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubj)}(hBridge ID: The Bridge ID is composed of two components: Bridge Priority and the MAC address of the bridge. It uniquely identifies each bridge in the network. The Bridge ID is used to compare the priorities of different bridges.h]h)}(hBridge ID: The Bridge ID is composed of two components: Bridge Priority and the MAC address of the bridge. It uniquely identifies each bridge in the network. The Bridge ID is used to compare the priorities of different bridges.h]hBridge ID: The Bridge ID is composed of two components: Bridge Priority and the MAC address of the bridge. It uniquely identifies each bridge in the network. The Bridge ID is used to compare the priorities of different bridges.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubj)}(hBridge Election: When the network starts, all bridges initially assume that they are the root bridge. They start advertising Bridge Protocol Data Units (BPDU) to their neighbors, containing their Bridge ID and other information.h]h)}(hBridge Election: When the network starts, all bridges initially assume that they are the root bridge. They start advertising Bridge Protocol Data Units (BPDU) to their neighbors, containing their Bridge ID and other information.h]hBridge Election: When the network starts, all bridges initially assume that they are the root bridge. They start advertising Bridge Protocol Data Units (BPDU) to their neighbors, containing their Bridge ID and other information.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubj)}(hXBPDU Comparison: Bridges exchange BPDUs to determine the root bridge. Each bridge examines the received BPDUs, including the Bridge Priority and Bridge ID, to determine if it should adjust its own priorities. The bridge with the lowest Bridge ID will become the root bridge.h]h)}(hXBPDU Comparison: Bridges exchange BPDUs to determine the root bridge. Each bridge examines the received BPDUs, including the Bridge Priority and Bridge ID, to determine if it should adjust its own priorities. The bridge with the lowest Bridge ID will become the root bridge.h]hXBPDU Comparison: Bridges exchange BPDUs to determine the root bridge. Each bridge examines the received BPDUs, including the Bridge Priority and Bridge ID, to determine if it should adjust its own priorities. The bridge with the lowest Bridge ID will become the root bridge.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubj)}(hX#Root Bridge Announcement: Once the root bridge is determined, it sends BPDUs with information about the root bridge to all other bridges in the network. This information is used by other bridges to calculate the shortest path to the root bridge and, in doing so, create a loop-free topology.h]h)}(hX#Root Bridge Announcement: Once the root bridge is determined, it sends BPDUs with information about the root bridge to all other bridges in the network. This information is used by other bridges to calculate the shortest path to the root bridge and, in doing so, create a loop-free topology.h]hX#Root Bridge Announcement: Once the root bridge is determined, it sends BPDUs with information about the root bridge to all other bridges in the network. This information is used by other bridges to calculate the shortest path to the root bridge and, in doing so, create a loop-free topology.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhj%ubah}(h]h ]h"]h$]h&]uh1jhj$ubj)}(hXForwarding Ports: After the root bridge is selected and the spanning tree topology is established, each bridge determines which of its ports should be in the forwarding state (used for data traffic) and which should be in the blocking state (used to prevent loops). The root bridge's ports are all in the forwarding state. while other bridges have some ports in the blocking state to avoid loops.h]h)}(hXForwarding Ports: After the root bridge is selected and the spanning tree topology is established, each bridge determines which of its ports should be in the forwarding state (used for data traffic) and which should be in the blocking state (used to prevent loops). The root bridge's ports are all in the forwarding state. while other bridges have some ports in the blocking state to avoid loops.h]hXForwarding Ports: After the root bridge is selected and the spanning tree topology is established, each bridge determines which of its ports should be in the forwarding state (used for data traffic) and which should be in the blocking state (used to prevent loops). The root bridge’s ports are all in the forwarding state. while other bridges have some ports in the blocking state to avoid loops.}(hj1%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshj-%ubah}(h]h ]h"]h$]h&]uh1jhj$ubj)}(hXRoot Ports: After the root bridge is selected and the spanning tree topology is established, each non-root bridge processes incoming BPDUs and determines which of its ports provides the shortest path to the root bridge based on the information in the received BPDUs. This port is designated as the root port. And it is in the Forwarding state, allowing it to actively forward network traffic.h]h)}(hXRoot Ports: After the root bridge is selected and the spanning tree topology is established, each non-root bridge processes incoming BPDUs and determines which of its ports provides the shortest path to the root bridge based on the information in the received BPDUs. This port is designated as the root port. And it is in the Forwarding state, allowing it to actively forward network traffic.h]hXRoot Ports: After the root bridge is selected and the spanning tree topology is established, each non-root bridge processes incoming BPDUs and determines which of its ports provides the shortest path to the root bridge based on the information in the received BPDUs. This port is designated as the root port. And it is in the Forwarding state, allowing it to actively forward network traffic.}(hjI%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjE%ubah}(h]h ]h"]h$]h&]uh1jhj$ubj)}(hXLDesignated ports: A designated port is the port through which the non-root bridge will forward traffic towards the designated segment. Designated ports are placed in the Forwarding state. All other ports on the non-root bridge that are not designated for specific segments are placed in the Blocking state to prevent network loops. h]h)}(hXKDesignated ports: A designated port is the port through which the non-root bridge will forward traffic towards the designated segment. Designated ports are placed in the Forwarding state. All other ports on the non-root bridge that are not designated for specific segments are placed in the Blocking state to prevent network loops.h]hXKDesignated ports: A designated port is the port through which the non-root bridge will forward traffic towards the designated segment. Designated ports are placed in the Forwarding state. All other ports on the non-root bridge that are not designated for specific segments are placed in the Blocking state to prevent network loops.}(hja%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj]%ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j$hj$ubah}(h]h ]h"]h$]h&]uh1jNhj$ubeh}(h]h ]h"]h$]h&]uh1j,hhhKhj$ubah}(h]h ]h"]h$]h&]uh1j'hjy$hhhNhNubh)}(hSTP ensures network convergence by calculating the shortest path and disabling redundant links. When network topology changes occur (e.g., a link failure), STP recalculates the network topology to restore connectivity while avoiding loops.h]hSTP ensures network convergence by calculating the shortest path and disabling redundant links. When network topology changes occur (e.g., a link failure), STP recalculates the network topology to restore connectivity while avoiding loops.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjy$hhubh)}(hProper configuration of STP parameters, such as the bridge priority, can influence network performance, path selection and which bridge becomes the Root Bridge.h]hProper configuration of STP parameters, such as the bridge priority, can influence network performance, path selection and which bridge becomes the Root Bridge.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjy$hhubeh}(h]root-bridge-and-convergenceah ]h"]root bridge and convergenceah$]h&]uh1hhjR#hhhhhKWubh)}(hhh](h)}(hUser space STP helperh]hUser space STP helper}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhKubh)}(hXThe user space STP helper *bridge-stp* is a program to control whether to use user mode spanning tree. The ``/sbin/bridge-stp `` is called by the kernel when STP is enabled/disabled on a bridge (via ``brctl stp `` or ``ip link set type bridge stp_state <0|1>``). The kernel enables user_stp mode if that command returns 0, or enables kernel_stp mode if that command returns any other value.h](hThe user space STP helper }(hj%hhhNhNubj )}(h *bridge-stp*h]h bridge-stp}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubhE is a program to control whether to use user mode spanning tree. The }(hj%hhhNhNubj9)}(h*``/sbin/bridge-stp ``h]h&/sbin/bridge-stp }(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj%ubhG is called by the kernel when STP is enabled/disabled on a bridge (via }(hj%hhhNhNubj9)}(h``brctl stp ``h]hbrctl stp }(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj%ubh or }(hj%hhhNhNubj9)}(h4``ip link set type bridge stp_state <0|1>``h]h0ip link set type bridge stp_state <0|1>}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj%ubh). The kernel enables user_stp mode if that command returns 0, or enables kernel_stp mode if that command returns any other value.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj%hhubeh}(h]user-space-stp-helperah ]h"]user space stp helperah$]h&]uh1hhjR#hhhhhKubh)}(hhh](h)}(hSTP mode selectionh]hSTP mode selection}(hj(&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%&hhhhhKubh)}(hThe ``IFLA_BR_STP_MODE`` bridge attribute allows explicit control over how STP operates when enabled, bypassing the ``/sbin/bridge-stp`` helper entirely for the ``user`` and ``kernel`` modes.h](hThe }(hj6&hhhNhNubj9)}(h``IFLA_BR_STP_MODE``h]hIFLA_BR_STP_MODE}(hj>&hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj6&ubh\ bridge attribute allows explicit control over how STP operates when enabled, bypassing the }(hj6&hhhNhNubj9)}(h``/sbin/bridge-stp``h]h/sbin/bridge-stp}(hjP&hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj6&ubh helper entirely for the }(hj6&hhhNhNubj9)}(h``user``h]huser}(hjb&hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj6&ubh and }(hj6&hhhNhNubj9)}(h ``kernel``h]hkernel}(hjt&hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj6&ubh modes.}(hj6&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj%&hhubj()}(hhh](j-)}(h**BR_STP_MODE_AUTO** Default. The kernel invokes the ``/sbin/bridge-stp`` helper to hand the bridge to a userspace STP daemon (e.g. mstpd). Only attempted in the initial network namespace; in other namespaces this falls back to kernel STP. h](j3)}(h**BR_STP_MODE_AUTO**h]j)}(hj&h]hBR_STP_MODE_AUTO}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1j2h_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhM0hj&ubjO)}(hhh]h)}(hDefault. The kernel invokes the ``/sbin/bridge-stp`` helper to hand the bridge to a userspace STP daemon (e.g. mstpd). Only attempted in the initial network namespace; in other namespaces this falls back to kernel STP.h](h Default. The kernel invokes the }(hj&hhhNhNubj9)}(h``/sbin/bridge-stp``h]h/sbin/bridge-stp}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj&ubh helper to hand the bridge to a userspace STP daemon (e.g. mstpd). Only attempted in the initial network namespace; in other namespaces this falls back to kernel STP.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhM-hj&ubah}(h]h ]h"]h$]h&]uh1jNhj&ubeh}(h]h ]h"]h$]h&]uh1j,hj&hM0hj&ubj-)}(h**BR_STP_MODE_USER** Directly enable userspace STP (``BR_USER_STP``) without invoking the ``/sbin/bridge-stp`` helper. Works in any network namespace. Userspace is responsible for ensuring an STP daemon manages the bridge. h](j3)}(h**BR_STP_MODE_USER**h]j)}(hj&h]hBR_STP_MODE_USER}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1j2h_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhM6hj&ubjO)}(hhh]h)}(hDirectly enable userspace STP (``BR_USER_STP``) without invoking the ``/sbin/bridge-stp`` helper. Works in any network namespace. Userspace is responsible for ensuring an STP daemon manages the bridge.h](hDirectly enable userspace STP (}(hj&hhhNhNubj9)}(h``BR_USER_STP``h]h BR_USER_STP}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj&ubh) without invoking the }(hj&hhhNhNubj9)}(h``/sbin/bridge-stp``h]h/sbin/bridge-stp}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj&ubhp helper. Works in any network namespace. Userspace is responsible for ensuring an STP daemon manages the bridge.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhM3hj&ubah}(h]h ]h"]h$]h&]uh1jNhj&ubeh}(h]h ]h"]h$]h&]uh1j,hj&hM6hj&ubj-)}(hc**BR_STP_MODE_KERNEL** Directly enable kernel STP (``BR_KERNEL_STP``) without invoking the helper. h](j3)}(h**BR_STP_MODE_KERNEL**h]j)}(hj?'h]hBR_STP_MODE_KERNEL}(hjA'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj='ubah}(h]h ]h"]h$]h&]uh1j2h_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhM:hj9'ubjO)}(hhh]h)}(hKDirectly enable kernel STP (``BR_KERNEL_STP``) without invoking the helper.h](hDirectly enable kernel STP (}(hjX'hhhNhNubj9)}(h``BR_KERNEL_STP``h]h BR_KERNEL_STP}(hj`'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjX'ubh) without invoking the helper.}(hjX'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhM9hjU'ubah}(h]h ]h"]h$]h&]uh1jNhj9'ubeh}(h]h ]h"]h$]h&]uh1j,hjT'hM:hj&ubeh}(h]h ]h"]h$]h&]uh1j'hj%&hhh_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhNubh)}(hX The mode controls how the bridge selects between userspace and kernel STP when STP is enabled via ``IFLA_BR_STP_STATE``. It can only be changed while STP is disabled (``IFLA_BR_STP_STATE`` == 0), returns ``-EBUSY`` otherwise. The default value is ``BR_STP_MODE_AUTO``.h](hbThe mode controls how the bridge selects between userspace and kernel STP when STP is enabled via }(hj'hhhNhNubj9)}(h``IFLA_BR_STP_STATE``h]hIFLA_BR_STP_STATE}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh0. It can only be changed while STP is disabled (}(hj'hhhNhNubj9)}(h``IFLA_BR_STP_STATE``h]hIFLA_BR_STP_STATE}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh == 0), returns }(hj'hhhNhNubj9)}(h ``-EBUSY``h]h-EBUSY}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh! otherwise. The default value is }(hj'hhhNhNubj9)}(h``BR_STP_MODE_AUTO``h]hBR_STP_MODE_AUTO}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh.}(hj'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/networking/bridge:158: ./include/uapi/linux/if_link.hhM<hj%&hhubh)}(hXUThe default mode is ``BR_STP_MODE_AUTO``, which preserves the traditional behavior of invoking the ``/sbin/bridge-stp`` helper. The ``user`` and ``kernel`` modes are particularly useful in network namespace environments where the helper mechanism is not available, as ``call_usermodehelper()`` is restricted to the initial network namespace.h](hThe default mode is }(hj'hhhNhNubj9)}(h``BR_STP_MODE_AUTO``h]hBR_STP_MODE_AUTO}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh;, which preserves the traditional behavior of invoking the }(hj'hhhNhNubj9)}(h``/sbin/bridge-stp``h]h/sbin/bridge-stp}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh helper. The }(hj'hhhNhNubj9)}(h``user``h]huser}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh and }(hj'hhhNhNubj9)}(h ``kernel``h]hkernel}(hj!(hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubhq modes are particularly useful in network namespace environments where the helper mechanism is not available, as }(hj'hhhNhNubj9)}(h``call_usermodehelper()``h]hcall_usermodehelper()}(hj3(hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj'ubh0 is restricted to the initial network namespace.}(hj'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj%&hhubh)}(h Example::h]hExample:}(hjK(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj%&hhubj)}(h9ip link set dev br0 type bridge stp_mode user stp_state 1h]h9ip link set dev br0 type bridge stp_mode user stp_state 1}hjY(sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj%&hhubh)}(h3The mode can only be changed while STP is disabled.h]h3The mode can only be changed while STP is disabled.}(hjg(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj%&hhubeh}(h]stp-mode-selectionah ]h"]stp mode selectionah$]h&]uh1hhjR#hhhhhKubeh}(h]stpah ]h"]stpah$]h&]uh1hhhhhhhhK3ubh)}(hhh](h)}(hVLANh]hVLAN}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hhhhhKubh)}(hX-A LAN (Local Area Network) is a network that covers a small geographic area, typically within a single building or a campus. LANs are used to connect computers, servers, printers, and other networked devices within a localized area. LANs can be wired (using Ethernet cables) or wireless (using Wi-Fi).h]hX-A LAN (Local Area Network) is a network that covers a small geographic area, typically within a single building or a campus. LANs are used to connect computers, servers, printers, and other networked devices within a localized area. LANs can be wired (using Ethernet cables) or wireless (using Wi-Fi).}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj(hhubh)}(hX+A VLAN (Virtual Local Area Network) is a logical segmentation of a physical network into multiple isolated broadcast domains. VLANs are used to divide a single physical LAN into multiple virtual LANs, allowing different groups of devices to communicate as if they were on separate physical networks.h]hX+A VLAN (Virtual Local Area Network) is a logical segmentation of a physical network into multiple isolated broadcast domains. VLANs are used to divide a single physical LAN into multiple virtual LANs, allowing different groups of devices to communicate as if they were on separate physical networks.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj(hhubh)}(hXTypically there are two VLAN implementations, IEEE 802.1Q and IEEE 802.1ad (also known as QinQ). IEEE 802.1Q is a standard for VLAN tagging in Ethernet networks. It allows network administrators to create logical VLANs on a physical network and tag Ethernet frames with VLAN information, which is called *VLAN-tagged frames*. IEEE 802.1ad, commonly known as QinQ or Double VLAN, is an extension of the IEEE 802.1Q standard. QinQ allows for the stacking of multiple VLAN tags within a single Ethernet frame. The Linux bridge supports both the IEEE 802.1Q and `802.1AD `_ protocol for VLAN tagging.h](hX0Typically there are two VLAN implementations, IEEE 802.1Q and IEEE 802.1ad (also known as QinQ). IEEE 802.1Q is a standard for VLAN tagging in Ethernet networks. It allows network administrators to create logical VLANs on a physical network and tag Ethernet frames with VLAN information, which is called }(hj(hhhNhNubj )}(h*VLAN-tagged frames*h]hVLAN-tagged frames}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh. IEEE 802.1ad, commonly known as QinQ or Double VLAN, is an extension of the IEEE 802.1Q standard. QinQ allows for the stacking of multiple VLAN tags within a single Ethernet frame. The Linux bridge supports both the IEEE 802.1Q and }(hj(hhhNhNubjz#)}(hl`802.1AD `_h]h802.1AD}(hj(hhhNhNubah}(h]h ]h"]h$]h&]name802.1ADj#_https://lore.kernel.org/netdev/1402401565-15423-1-git-send-email-makita.toshiaki@lab.ntt.co.jp/uh1jy#hj(ubj#)}(hb h]h}(h]adah ]h"]802.1adah$]h&]refurij(uh1j#j#Khj(ubh protocol for VLAN tagging.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj(hhubh)}(hX;`VLAN filtering `_ on a bridge is disabled by default. After enabling VLAN filtering on a bridge, it will start forwarding frames to appropriate destinations based on their destination MAC address and VLAN tag (both must match).h](jz#)}(hi`VLAN filtering `_h]hVLAN filtering}(hj(hhhNhNubah}(h]h ]h"]h$]h&]nameVLAN filteringj#Uhttps://lore.kernel.org/netdev/1360792820-14116-1-git-send-email-vyasevic@redhat.com/uh1jy#hj(ubj#)}(hX h]h}(h]vlan-filteringah ]h"]vlan filteringah$]h&]refurij)uh1j#j#Khj(ubh on a bridge is disabled by default. After enabling VLAN filtering on a bridge, it will start forwarding frames to appropriate destinations based on their destination MAC address and VLAN tag (both must match).}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj(hhubeh}(h]vlanah ]h"]vlanah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Multicasth]h Multicast}(hj+)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj()hhhhhKubh)}(hX The Linux bridge driver has multicast support allowing it to process Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (MLD) messages, and to efficiently forward multicast data packets. The bridge driver supports IGMPv2/IGMPv3 and MLDv1/MLDv2.h]hX The Linux bridge driver has multicast support allowing it to process Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (MLD) messages, and to efficiently forward multicast data packets. The bridge driver supports IGMPv2/IGMPv3 and MLDv1/MLDv2.}(hj9)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj()hhubh)}(hhh](h)}(hMulticast snoopingh]hMulticast snooping}(hjJ)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjG)hhhhhKubh)}(hMulticast snooping is a networking technology that allows network switches to intelligently manage multicast traffic within a local area network (LAN).h]hMulticast snooping is a networking technology that allows network switches to intelligently manage multicast traffic within a local area network (LAN).}(hjX)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjG)hhubh)}(hXCThe switch maintains a multicast group table, which records the association between multicast group addresses and the ports where hosts have joined these groups. The group table is dynamically updated based on the IGMP/MLD messages received. With the multicast group information gathered through snooping, the switch optimizes the forwarding of multicast traffic. Instead of blindly broadcasting the multicast traffic to all ports, it sends the multicast traffic based on the destination MAC address only to ports which have subscribed the respective destination multicast group.h]hXCThe switch maintains a multicast group table, which records the association between multicast group addresses and the ports where hosts have joined these groups. The group table is dynamically updated based on the IGMP/MLD messages received. With the multicast group information gathered through snooping, the switch optimizes the forwarding of multicast traffic. Instead of blindly broadcasting the multicast traffic to all ports, it sends the multicast traffic based on the destination MAC address only to ports which have subscribed the respective destination multicast group.}(hjf)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjG)hhubh)}(hWhen created, the Linux bridge devices have multicast snooping enabled by default. It maintains a Multicast forwarding database (MDB) which keeps track of port and group relationships.h]hWhen created, the Linux bridge devices have multicast snooping enabled by default. It maintains a Multicast forwarding database (MDB) which keeps track of port and group relationships.}(hjt)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjG)hhubeh}(h]multicast-snoopingah ]h"]multicast snoopingah$]h&]uh1hhj()hhhhhKubh)}(hhh](h)}(hIGMPv3/MLDv2 EHT supporth]hIGMPv3/MLDv2 EHT support}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hhhhhKubh)}(hThe Linux bridge supports IGMPv3/MLDv2 EHT (Explicit Host Tracking), which was added by `474ddb37fa3a ("net: bridge: multicast: add EHT allow/block handling") `_h](hXThe Linux bridge supports IGMPv3/MLDv2 EHT (Explicit Host Tracking), which was added by }(hj)hhhNhNubjz#)}(h`474ddb37fa3a ("net: bridge: multicast: add EHT allow/block handling") `_h]hI474ddb37fa3a (“net: bridge: multicast: add EHT allow/block handling”)}(hj)hhhNhNubah}(h]h ]h"]h$]h&]nameE474ddb37fa3a ("net: bridge: multicast: add EHT allow/block handling")j#Lhttps://lore.kernel.org/netdev/20210120145203.1109140-1-razor@blackwall.org/uh1jy#hj)ubj#)}(hO h]h}(h];ddb37fa3a-net-bridge-multicast-add-eht-allow-block-handlingah ]h"]E474ddb37fa3a ("net: bridge: multicast: add eht allow/block handling")ah$]h&]refurij)uh1j#j#Khj)ubeh}(h]h ]h"]h$]h&]uh1hhhhKhj)hhubh)}(hXThe explicit host tracking enables the device to keep track of each individual host that is joined to a particular group or channel. The main benefit of the explicit host tracking in IGMP is to allow minimal leave latencies when a host leaves a multicast group or channel.h]hXThe explicit host tracking enables the device to keep track of each individual host that is joined to a particular group or channel. The main benefit of the explicit host tracking in IGMP is to allow minimal leave latencies when a host leaves a multicast group or channel.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj)hhubh)}(hXThe length of time between a host wanting to leave and a device stopping traffic forwarding is called the IGMP leave latency. A device configured with IGMPv3 or MLDv2 and explicit tracking can immediately stop forwarding traffic if the last host to request to receive traffic from the device indicates that it no longer wants to receive traffic. The leave latency is thus bound only by the packet transmission latencies in the multiaccess network and the processing time in the device.h]hXThe length of time between a host wanting to leave and a device stopping traffic forwarding is called the IGMP leave latency. A device configured with IGMPv3 or MLDv2 and explicit tracking can immediately stop forwarding traffic if the last host to request to receive traffic from the device indicates that it no longer wants to receive traffic. The leave latency is thus bound only by the packet transmission latencies in the multiaccess network and the processing time in the device.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj)hhubeh}(h]igmpv3-mldv2-eht-supportah ]h"]igmpv3/mldv2 eht supportah$]h&]uh1hhj()hhhhhKubh)}(hhh](h)}(hOther multicast featuresh]hOther multicast features}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hhhhhKubh)}(hXhThe Linux bridge also supports `per-VLAN multicast snooping `_, which is disabled by default but can be enabled. And `Multicast Router Discovery `_, which help identify the location of multicast routers.h](hThe Linux bridge also supports }(hj)hhhNhNubjz#)}(hl`per-VLAN multicast snooping `_h]hper-VLAN multicast snooping}(hj*hhhNhNubah}(h]h ]h"]h$]h&]nameper-VLAN multicast snoopingj#Khttps://lore.kernel.org/netdev/20210719170637.435541-1-razor@blackwall.org/uh1jy#hj)ubj#)}(hN h]h}(h]per-vlan-multicast-snoopingah ]h"]per-vlan multicast snoopingah$]h&]refurij*uh1j#j#Khj)ubh7, which is disabled by default but can be enabled. And }(hj)hhhNhNubjz#)}(hn`Multicast Router Discovery `_h]hMulticast Router Discovery}(hj&*hhhNhNubah}(h]h ]h"]h$]h&]nameMulticast Router Discoveryj#Nhttps://lore.kernel.org/netdev/20190121062628.2710-1-linus.luessing@c0d3.blue/uh1jy#hj)ubj#)}(hQ h]h}(h]multicast-router-discoveryah ]h"]multicast router discoveryah$]h&]refurij6*uh1j#j#Khj)ubh8, which help identify the location of multicast routers.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj)hhubeh}(h]other-multicast-featuresah ]h"]other multicast featuresah$]h&]uh1hhj()hhhhhKubeh}(h] multicastah ]h"] multicastah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Switchdevh]h Switchdev}(hja*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^*hhhhhMubh)}(hXLinux Bridge Switchdev is a feature in the Linux kernel that extends the capabilities of the traditional Linux bridge to work more efficiently with hardware switches that support switchdev. With Linux Bridge Switchdev, certain networking functions like forwarding, filtering, and learning of Ethernet frames can be offloaded to a hardware switch. This offloading reduces the burden on the Linux kernel and CPU, leading to improved network performance and lower latency.h]hXLinux Bridge Switchdev is a feature in the Linux kernel that extends the capabilities of the traditional Linux bridge to work more efficiently with hardware switches that support switchdev. With Linux Bridge Switchdev, certain networking functions like forwarding, filtering, and learning of Ethernet frames can be offloaded to a hardware switch. This offloading reduces the burden on the Linux kernel and CPU, leading to improved network performance and lower latency.|E}(hjo*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj^*hhubh)}(hTo use Linux Bridge Switchdev, you need hardware switches that support the switchdev interface. This means that the switch hardware needs to have the necessary drivers and functionality to work in conjunction with the Linux kernel.h]hTo use Linux Bridge Switchdev, you need hardware switches that support the switchdev interface. This means that the switch hardware needs to have the necessary drivers and functionality to work in conjunction with the Linux kernel.}(hj}*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj^*hhubh)}(h:Please see the :ref:`switchdev` document for more details.h](hPlease see the }(hj*hhhNhNubh)}(h:ref:`switchdev`h]hinline)}(hj*h]h switchdev}(hj*hhhNhNubah}(h]h ](xrefstdstd-refeh"]h$]h&]uh1j*hj*ubah}(h]h ]h"]h$]h&]refdocnetworking/bridge refdomainj*reftyperef refexplicitrefwarn reftarget switchdevuh1hhhhMhj*ubh document for more details.}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj^*hhubeh}(h] switchdevah ]h"] switchdevah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(h Netfilterh]h Netfilter}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhMubh)}(hThe bridge netfilter module is a legacy feature that allows to filter bridged packets with iptables and ip6tables. This feature is scheduled for removal and not available in user namespaces. Consider using nftables for packet filtering instead.h]hThe bridge netfilter module is a legacy feature that allows to filter bridged packets with iptables and ip6tables. This feature is scheduled for removal and not available in user namespaces. Consider using nftables for packet filtering instead.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*hhubh)}(hThe older ebtables tool is more feature-limited compared to nftables, but just like nftables it doesn't need this module either to function.h]hThe older ebtables tool is more feature-limited compared to nftables, but just like nftables it doesn’t need this module either to function.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*hhubh)}(hX@The br_netfilter module intercepts packets entering the bridge, performs minimal sanity tests on ipv4 and ipv6 packets and then pretends that these packets are being routed, not bridged. br_netfilter then calls the ip and ipv6 netfilter hooks from the bridge layer, i.e. ip(6)tables rulesets will also see these packets.h]hX@The br_netfilter module intercepts packets entering the bridge, performs minimal sanity tests on ipv4 and ipv6 packets and then pretends that these packets are being routed, not bridged. br_netfilter then calls the ip and ipv6 netfilter hooks from the bridge layer, i.e. ip(6)tables rulesets will also see these packets.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*hhubh)}(hbr_netfilter is also the reason for the iptables *physdev* match: This match is the only way to reliably tell routed and bridged packets apart in an iptables ruleset.h](h1br_netfilter is also the reason for the iptables }(hj+hhhNhNubj )}(h *physdev*h]hphysdev}(hj +hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubhl match: This match is the only way to reliably tell routed and bridged packets apart in an iptables ruleset.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM%hj*hhubh)}(hX>Note that ebtables and nftables will work fine without the br_netfilter module. iptables/ip6tables/arptables do not work for bridged traffic because they plug in the routing stack. nftables rules in ip/ip6/inet/arp families won't see traffic that is forwarded by a bridge either, but that's very much how it should be.h]hXBNote that ebtables and nftables will work fine without the br_netfilter module. iptables/ip6tables/arptables do not work for bridged traffic because they plug in the routing stack. nftables rules in ip/ip6/inet/arp families won’t see traffic that is forwarded by a bridge either, but that’s very much how it should be.}(hj%+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM)hj*hhubh)}(hXHistorically the feature set of ebtables was very limited (it still is), this module was added to pretend packets are routed and invoke the ipv4/ipv6 netfilter hooks from the bridge so users had access to the more feature-rich iptables matching capabilities (including conntrack). nftables doesn't have this limitation, pretty much all features work regardless of the protocol family.h]hXHistorically the feature set of ebtables was very limited (it still is), this module was added to pretend packets are routed and invoke the ipv4/ipv6 netfilter hooks from the bridge so users had access to the more feature-rich iptables matching capabilities (including conntrack). nftables doesn’t have this limitation, pretty much all features work regardless of the protocol family.}(hj3+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM/hj*hhubh)}(hSo, br_netfilter is only needed if users, for some reason, need to use ip(6)tables to filter packets forwarded by the bridge, or NAT bridged traffic. For pure link layer filtering, this module isn't needed.h]hSo, br_netfilter is only needed if users, for some reason, need to use ip(6)tables to filter packets forwarded by the bridge, or NAT bridged traffic. For pure link layer filtering, this module isn’t needed.}(hjA+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM5hj*hhubeh}(h] netfilterah ]h"] netfilterah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hOther Featuresh]hOther Features}(hjZ+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjW+hhhhhM:ubh)}(hXThe Linux bridge also supports `IEEE 802.11 Proxy ARP `_, `Media Redundancy Protocol (MRP) `_, `Media Redundancy Protocol (MRP) LC mode `_, `IEEE 802.1X port authentication `_, and `MAC Authentication Bypass (MAB) `_.h](hThe Linux bridge also supports }(hjh+hhhNhNubjz#)}(h`IEEE 802.11 Proxy ARP `_h]hIEEE 802.11 Proxy ARP}(hjp+hhhNhNubah}(h]h ]h"]h$]h&]nameIEEE 802.11 Proxy ARPj#vhttps://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=958501163ddd6ea22a98f94fa0e7ce6d4734e5c4uh1jy#hjh+ubj#)}(hy h]h}(h]ieee-802-11-proxy-arpah ]h"]ieee 802.11 proxy arpah$]h&]refurij+uh1j#j#Khjh+ubh, }(hjh+hhhNhNubjz#)}(hw`Media Redundancy Protocol (MRP) `_h]hMedia Redundancy Protocol (MRP)}(hj+hhhNhNubah}(h]h ]h"]h$]h&]nameMedia Redundancy Protocol (MRP)j#Rhttps://lore.kernel.org/netdev/20200426132208.3232-1-horatiu.vultur@microchip.com/uh1jy#hjh+ubj#)}(hU h]h}(h]media-redundancy-protocol-mrpah ]h"]media redundancy protocol (mrp)ah$]h&]refurij+uh1j#j#Khjh+ubh, }hjh+sbjz#)}(h{`Media Redundancy Protocol (MRP) LC mode `_h]h'Media Redundancy Protocol (MRP) LC mode}(hj+hhhNhNubah}(h]h ]h"]h$]h&]name'Media Redundancy Protocol (MRP) LC modej#Nhttps://lore.kernel.org/r/20201124082525.273820-1-horatiu.vultur@microchip.comuh1jy#hjh+ubj#)}(hQ h]h}(h]%media-redundancy-protocol-mrp-lc-modeah ]h"]'media redundancy protocol (mrp) lc modeah$]h&]refurij+uh1j#j#Khjh+ubh, }hjh+sbjz#)}(h{`IEEE 802.1X port authentication `_h]hIEEE 802.1X port authentication}(hj+hhhNhNubah}(h]h ]h"]h$]h&]nameIEEE 802.1X port authenticationj#Vhttps://lore.kernel.org/netdev/20220218155148.2329797-1-schultz.hans+netdev@gmail.com/uh1jy#hjh+ubj#)}(hY h]h}(h]ieee-802-1x-port-authenticationah ]h"]ieee 802.1x port authenticationah$]h&]refurij+uh1j#j#Khjh+ubh, and }(hjh+hhhNhNubjz#)}(ho`MAC Authentication Bypass (MAB) `_h]hMAC Authentication Bypass (MAB)}(hj+hhhNhNubah}(h]h ]h"]h$]h&]nameMAC Authentication Bypass (MAB)j#Jhttps://lore.kernel.org/netdev/20221101193922.2125323-2-idosch@nvidia.com/uh1jy#hjh+ubj#)}(hM h]h}(h]mac-authentication-bypass-mabah ]h"]mac authentication bypass (mab)ah$]h&]refurij,uh1j#j#Khjh+ubh.}(hjh+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM<hjW+hhubeh}(h]other-featuresah ]h"]other featuresah$]h&]uh1hhhhhhhhM:ubh)}(hhh](h)}(hFAQh]hFAQ}(hj+,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(,hhhhhMHubh)}(hhh](h)}(hWhat does a bridge do?h]hWhat does a bridge do?}(hj<,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9,hhhhhMKubh)}(hA bridge transparently forwards traffic between multiple network interfaces. In plain English this means that a bridge connects two or more physical Ethernet networks, to form one larger (logical) Ethernet network.h]hA bridge transparently forwards traffic between multiple network interfaces. In plain English this means that a bridge connects two or more physical Ethernet networks, to form one larger (logical) Ethernet network.}(hjJ,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMMhj9,hhubeh}(h]what-does-a-bridge-doah ]h"]what does a bridge do?ah$]h&]uh1hhj(,hhhhhMKubh)}(hhh](h)}(hIs it L3 protocol independent?h]hIs it L3 protocol independent?}(hjc,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`,hhhhhMRubh)}(hYes. The bridge sees all frames, but it *uses* only L2 headers/information. As such, the bridging functionality is protocol independent, and there should be no trouble forwarding IPX, NetBEUI, IP, IPv6, etc.h](h(Yes. The bridge sees all frames, but it }(hjq,hhhNhNubj )}(h*uses*h]huses}(hjy,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq,ubh only L2 headers/information. As such, the bridging functionality is protocol independent, and there should be no trouble forwarding IPX, NetBEUI, IP, IPv6, etc.}(hjq,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMThj`,hhubeh}(h]is-it-l3-protocol-independentah ]h"]is it l3 protocol independent?ah$]h&]uh1hhj(,hhhhhMRubeh}(h]faqah ]h"]faqah$]h&]uh1hhhhhhhhMHubh)}(hhh](h)}(h Contact Infoh]h Contact Info}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hhhhhMYubh)}(hThe code is currently maintained by Roopa Prabhu and Nikolay Aleksandrov . Bridge bugs and enhancements are discussed on the linux-netdev mailing list netdev@vger.kernel.org and bridge@lists.linux.dev.h](h2The code is currently maintained by Roopa Prabhu <}(hj,hhhNhNubjz#)}(hroopa@nvidia.comh]hroopa@nvidia.com}(hj,hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:roopa@nvidia.comuh1jy#hj,ubh> and Nikolay Aleksandrov <}(hj,hhhNhNubjz#)}(hrazor@blackwall.orgh]hrazor@blackwall.org}(hj,hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:razor@blackwall.orguh1jy#hj,ubhO>. Bridge bugs and enhancements are discussed on the linux-netdev mailing list }(hj,hhhNhNubjz#)}(hnetdev@vger.kernel.orgh]hnetdev@vger.kernel.org}(hj,hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:netdev@vger.kernel.orguh1jy#hj,ubh and }(hj,hhhNhNubjz#)}(hbridge@lists.linux.devh]hbridge@lists.linux.dev}(hj,hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:bridge@lists.linux.devuh1jy#hj,ubh.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM[hj,hhubh)}(hTThe list is open to anyone interested: http://vger.kernel.org/vger-lists.html#netdevh](h'The list is open to anyone interested: }(hj-hhhNhNubjz#)}(h-http://vger.kernel.org/vger-lists.html#netdevh]h-http://vger.kernel.org/vger-lists.html#netdev}(hj-hhhNhNubah}(h]h ]h"]h$]h&]refurij-uh1jy#hj-ubeh}(h]h ]h"]h$]h&]uh1hhhhM`hj,hhubeh}(h] contact-infoah ]h"] contact infoah$]h&]uh1hhhhhhhhMYubh)}(hhh](h)}(hExternal Linksh]hExternal Links}(hj8-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5-hhhhhMcubh)}(hbThe old Documentation for Linux bridging is on: https://wiki.linuxfoundation.org/networking/bridgeh](h0The old Documentation for Linux bridging is on: }(hjF-hhhNhNubjz#)}(h2https://wiki.linuxfoundation.org/networking/bridgeh]h2https://wiki.linuxfoundation.org/networking/bridge}(hjN-hhhNhNubah}(h]h ]h"]h$]h&]refurijP-uh1jy#hjF-ubeh}(h]h ]h"]h$]h&]uh1hhhhMehj5-hhubeh}(h]external-linksah ]h"]external linksah$]h&]uh1hhhhhhhhMcubeh}(h]ethernet-bridgingah ]h"]ethernet bridgingah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj-error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jp-jm-jjjVjSjO#jL#jAj>j #j#jG#jD#j(j(j#j#jv$js$j%j%j"&j&jz(jw(j%)j")j(j(j)j)j[*jX*j)j)j)j)j)j)jS*jP*j*j*j@*j=*j*j*jT+jQ+j%,j",j+j+j+j+j+j+j+j+j,j,j,j,j],jZ,j,j,j2-j/-jh-je-u nametypes}(jp-jjVjO#jAj #jG#j(j#jv$j%j"&jz(j%)j(j)j[*j)j)j)jS*j*j@*j*jT+j%,j+j+j+j+j,j,j],j,j2-jh-uh}(jm-hjhjSjjHjRjL#jYj>jxj#jDjD#j##j(jR#j#j#js$j#j%jy$j&j%jw(j%&j")j(j(j(j)j )jX*j()j)jG)j)j)j)j)jP*j)j*j*j=*j7*j*j^*jQ+j*j",jW+j+j+j+j+j+j+j+j+j,j ,j,j(,jZ,j9,j,j`,j/-j,je-j5-u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.