BRIDGE(8) Linux BRIDGE(8) (NAME) bridge - Ethernet (SYNOPSIS) bridge [ OPTIONS ] OBJECT { COMMAND | help } OBJECT := { link | fdb | mdb | vlan | vni | monitor } OPTIONS := { -V[ersion] | -s[tatistics] | -n[etns] name | -b[atch] filename | -com[pressvlans] | -c[olor] | -p[retty] | -j[son] | -o[neline] } bridge link set dev DEV [ cost COST ] [ priority PRIO ] [ state STATE ] [ guard { on | off } ] [ hairpin { on | off } ] [ fastleave { on | off } ] [ root_block { on | off } ] [ learning { on | off } ] [ learning_sync { on | off } ] [ flood { on | off } ] [ hwmode { vepa | veb } ] [ bcast_flood { on | off } ] [ mcast_flood { on | off } ] [ mcast_max_groups MAX_GROUPS ] [ mcast_router MULTICAST_ROUTER ] [ mcast_to_unicast { on | off } ] [ neigh_suppress { on | off } ] [ neigh_vlan_suppress { on | off } ] [ neigh_forward_grat { on | off } ] [ vlan_tunnel { on | off } ] [ isolated { on | off } ] [ locked { on | off } ] [ mab { on | off } ] [ backup_port DEVICE ] [ nobackup_port ] [ backup_nhid NHID ] [ self ] [ master ] bridge link [ show ] [ dev DEV ] [ master DEVICE ] bridge fdb { add | append | del | replace } LLADDR dev DEV { local | static | dynamic } [ self ] [ master ] [ router ] [ use ] [ extern_learn ] [ sticky ] [ src_vni VNI ] { [ dst IPADDR ] [ vni VNI ] [ port PORT ] [ via DEVICE ] | nhid NHID } [ activity_notify ] [ inactive ] [ norefresh ] bridge fdb [ [ show ] [ br BRDEV ] [ brport DEV ] [ vlan VID ] [ state STATE ] [ dynamic ] ] bridge fdb get [ to ] LLADDR [ br BRDEV ] { brport | dev } DEV [ vlan VID ] [ vni VNI ] [ self ] [ master ] [ dynamic ] bridge fdb flush dev DEV [ brport DEV ] [ vlan VID ] [ src_vni VNI ] [ nhid NHID ] [ vni VNI ] [ port PORT ] [ dst IPADDR ] [ self ] [ master ] [ [no]permanent | [no]static | [no]dynamic ] [ [no]added_by_user ] [ [no]extern_learn ] [ [no]sticky ] [ [no]offloaded ] [ [no]router ] bridge mdb { add | del | replace } dev DEV port PORT grp GROUP [ src SOURCE ] [ permanent | temp ] [ vid VID ] [ filter_mode { include | exclude } ] [ source_list SOURCE_LIST ] [ proto PROTO ] [ dst IPADDR ] [ dst_port DST_PORT ] [ vni VNI ] [ src_vni SRC_VNI ] [ via DEV ] bridge mdb show [ dev DEV ] bridge mdb get dev DEV grp GROUP [ src SOURCE ] [ vid VID ] [ src_vni SRC_VNI ] bridge mdb flush dev DEV [ port PORT ] [ vid VID ] [ src_vni SRC_VNI ] [ proto PROTO ] [ [no]permanent ] [ dst IPADDR ] [ dst_port DST_PORT ] [ vni VNI ] bridge mst set dev DEV msti MSTI state STP_STATE bridge mst [ [ show ] [ dev DEV ] ] bridge vlan { add | del } dev DEV vid VID [ tunnel_info TUNNEL_ID ] [ pvid ] [ untagged ] [ self ] [ master ] bridge vlan set dev DEV vid VID [ state STP_STATE ] [ mcast_max_groups MAX_GROUPS ] [ mcast_router MULTICAST_ROUTER ] [ neigh_suppress { on | off } ] [ neigh_forward_grat { on | off } ] bridge vlan [ show | tunnelshow ] [ dev DEV ] bridge vlan global set dev DEV vid VID [ mcast_snooping MULTICAST_SNOOPING ] [ mcast_querier MULTICAST_QUERIER ] [ mcast_igmp_version IGMP_VERSION ] [ mcast_mld_version MLD_VERSION ] [ mcast_last_member_count LAST_MEMBER_COUNT ] [ mcast_last_member_interval LAST_MEMBER_INTERVAL ] [ mcast_startup_query_count STARTUP_QUERY_COUNT ] [ mcast_startup_query_interval STARTUP_QUERY_INTERVAL ] [ mcast_membership_interval MEMBERSHIP_INTERVAL ] [ mcast_querier_interval QUERIER_INTERVAL ] [ mcast_query_interval QUERY_INTERVAL ] [ mcast_query_response_interval QUERY_RESPONSE_INTERVAL ] [ msti MSTI ] bridge vlan global [ show ] [ dev DEV ] [ vid VID ] bridge vlan show [ dev DEV ] bridge vni { add | del } dev DEV vni VNI [ { group | remote } IPADDR ] bridge vni show [ dev DEV ] bridge monitor [ all | neigh | link | mdb | vlan ] (OPTIONS) -V, -Version bridge . -s, -stats, -statistics . . . -d, -details vlan MDB . -n, -net, -netns bridge (network namespace) NETNS . : ip netns exec NETNS bridge [ OPTIONS ] OBJECT { COMMAND | help } : bridge -n[etns] NETNS [ OPTIONS ] OBJECT { COMMAND | help } -b, -batch . bridge . -force bridge . . -com, -compressvlans VLAN . VLAN VLAN . (off) . -c[color][={always|auto|never} . always stdout . auto stdout . never . . -json . -j, -json (JSON) . -p, -pretty -j JSON . -o, -oneline '\' . wc(1) grep(1) . BRIDGE (COMMAND SYNTAX) OBJECT link - (Bridge port). fdb - (Forwarding Database entry). mdb - (Multicast group database entry). vlan - VLAN. vni - VNI. COMMAND . . add delete show ( list ) . help . . . list help . bridge link - (bridge port) link . . bridge link set - dev NAME cost COST STP . priority PRIO STP. ( 0 255). (designated port) (root port) . state STATE . 0 ( BPDU STP) STP/RSTP . ( ) . . 0 - STP DISABLED . STP . BPDU STP (leaf) . 1 - STP LISTENING . STP . BPDU STP . 2 - STP LEARNING . STP . MAC . 3 - STP FORWARDING . . 4 - STP BLOCKING . STP . STP . BPDU STP . guard on guard off BPDU STP . BPDU . BPDU STP . (Spanning Tree) BPDU . guard on . . guard eth0 : ip link set dev eth0 down; ip link set dev eth0 up hairpin on hairpin off . reflective relay VEPA (Virtual Ethernet Port Aggregator) . . fastleave on fastleave off IGMP Leave . IGMP snooping . . root_block on root_block off (root port) . STP . . (root port guard) . BPDU (edge) . STP . learning on learning off MAC . FDB (flood) . . learning_sync on learning_sync off MAC FDB . flood on flood off (unicast) FDB . . hwmode . : vepa - . veb - . bcast_flood on bcast_flood off (broadcast) . . mcast_flood on mcast_flood off (multicast) MDB . . mcast_max_groups MAX_GROUPS MDB . MDB netlink ( bridge) IGMP MLD. 0 . 0 . mcast_hash_max ip link . mcast_router MULTICAST_ROUTER VLAN ( ) 0-2 . 1 IGMP/MLD MRDISC PIM . 2 ( SMCRoute mrouted) IP / . mcast_to_unicast on mcast_to_unicast off (unicast) . . MAC . mcast_to_unicast (multicast snooping) . IGMP/MLD . / ( WiFi). IGMPv2/MLDv1 . IGMP/MLD (supplicant) AP (AP isolation) STA . IP STA STA hairpin ( hairpin ). hairpin multicast snooping STA . neigh_suppress on neigh_suppress off (arp nd) . . neigh_vlan_suppress on neigh_vlan_suppress off (arp nd) VLAN . bridge link neigh_suppress VLAN neigh_suppress bridge vlan . . neigh_forward_grat on neigh_forward_grat off ARP (gratuitous ARP) (unsolicited Neighbor Advertisement) . gratuitous ARP unsolicited NA . . vlan_tunnel on vlan_tunnel off vlan . . isolated on isolated off . . locked on locked off . link-local FDB MAC . IEEE 802.1X EAPOL (authenticator) . FDB . (learning) no_linklocal_learn EAPOL . . mab on mab off MAC (MAB MAC Authentication Bypass) . MAB . FDB FDB "locked" . FDB . FDB "locked" . FDB () (roam) "locked" . FDB MAB . FDB FDB {MAC, VID} . . FDB (aging) . . backup_port DEVICE (carrier) . nobackup_port . backup_nhid NHID FDB ( ip- nexthop(8) ) VLAN ( vlan_tunnel) . 0 () . self . master (). -t, -timestamp monitor. bridge link show - . dev DEV DEV . master DEVICE DEVICE . "ip link show master " . bridge fdb - (forwarding database) fdb . fdb . bridge fdb add - fdb fdb . LLADDR MAC. dev DEV . local - fdb MAC VLAN . "static" "dynamic" . permanent - "local" . static - fdb ( arp) . dynamic - fdb (age-able) . self - . master ( ). "bridge fdb add" fdb ( ). "self" . "master" . master - master master . master ( ) . router - . VXLAN (route short circuit) . use - . fdb . extern_learn - . . (age) . sticky - . DEV VXLAN . dst IPADDR IP VXLAN MAC . src_vni VNI VNI ( VXLAN) . vxlan (metadata) . vxlan . vni VNI VNI VXLAN ( VXLAN) VXLAN . vxlan . port PORT PORT UDP VXLAN . . via DEVICE VXLAN VXLAN . nhid NHID ecmp VXLAN VXLAN . activity_notify FDB . . inactive . inactive FDB . activity_notify FDB ( ) . norefresh FDB ( ) . . bridge fdb append - fdb LLADDR . . MAC . MAC vxlan . bridge fdb add . bridge fdb delete - fdb . bridge fdb add . bridge fdb replace - . bridge fdb add . bridge fdb show - . -statistics (verbose) . . bridge fdb get - . LLADDR MAC. dev DEV . brport DEV dev . br DEV . self - fdb . . master - fdb master . (). bridge fdb flush - . "no" ( permanent nopermanent). dev DEV . "master" master . brport DEV . . dev . vlan VID VLAN . VLAN . src_vni VNI VNI ( VXLAN) . VNI . VXLAN . nhid NHID ECMP . NHID . VXLAN . vni VNI VNI VXLAN ( VXLAN) . VNI . VXLAN . port PORT PORT UDP . PORT . VXLAN . dst IPADDR IP VXLAN . IPADDR . VXLAN . self . master . "bridge fdb flush" . "master" . master master master . 'master' 'self' ( vlan vni) . VXLAN . - 'self' 'master' . [no]permanent "no" . [no]static "no" . [no]dynamic "no" ( ) . [no]added_by_user added_by_user "no" added_by_user . [no]extern_learn extern_learn "no" extern_learn . [no]sticky sticky "no" sticky . [no]offloaded offloaded "no" offloaded . [no]router router "no" router . VXLAN . bridge mdb - (multicast group database) mdb IP L2 . mdb . bridge mdb add - mdb . dev DEV . port PORT . grp GROUP (IPv4 IPv6 L2) . permanent - mdb . IPv4 IPv6 L2 . temp - mdb (). src SOURCE IP . IGMPv3 IPv4 MLDv2 IPv6 . vid VID VLAN . filter_mode include filter_mode exclude INCLUDE EXCLUDE . (*, G) . source_list SOURCE_LIST IP '' . (filter mode) . (*, G) . proto PROTO mdb. /etc/iproute2/rt_protos . static . DEV VXLAN . dst IPADDR IP VXLAN . dst_port DST_PORT UDP VXLAN . VXLAN . vni VNI VNI VXLAN VXLAN . VXLAN VNI VXLAN . src_vni SRC_VNI VNI . VXLAN . VXLAN . via DEV VXLAN VXLAN . MDB 0.0.0.0 :: (catchall) IPv4 IPv6 . FDB 00:00:00:00:00:00 link-local . bridge mdb delete - mdb . bridge mdb add . bridge mdb replace - . bridge mdb add . bridge mdb show - . IGMP MLD snooping . bridge mdb add bridge mdb del . dev DEV . . -details (verbose) . . -statistics mdb . bridge mdb get - . dev DEV . grp GROUP (IPv4 IPv6 L2). src SOURCE IP . (S, G) . vid VID VLAN. VLAN . src_vni SRC_VNI VNI . VXLAN . bridge mdb flush - . dev DEV . port PORT . . vid VID VLAN . VLAN . src_vni SRC_VNI VNI . VNI . proto PROTO . . /etc/iproute2/rt_protos . [no]permanent "no" (temp) . dst IPADDR IP VXLAN . IP . dst_port DST_PORT UDP VXLAN . . vni VNI VNI VXLAN VXLAN . VNI . bridge mst - (MST) (MST) VLAN . VLAN (forward) (block) . mst_enable VLAN (MSTI) bridge vlan global set. bridge mst set - DEV MSTI STP_STATE. dev DEV . msti MSTI (MSTI). state STP_STATE state bridge link set . bridge mst show - MST MST MSTI. dev DEV . bridge vlan - VLAN vlan VLAN . vlan . bridge vlan add - vlan vlan . dev NAME vlan . vid VID VLAN vlan . tunnel_info TUNNEL_ID (TUNNEL ID) vlan . dst_metadata vlan ( vlan_tunnel). pvid (vlan) (ingress) PVID . (untagged) VLAN . untagged (vlan) (egress) (untagged) . self (vlan) . . master (vlan) (). bridge vlan delete - vlan vlan . bridge vlan add . pvid untagged . bridge vlan set - vlan vlan . dev NAME vlan . vid VID VLAN vlan . state STP_STATE vlan. STP ( ) . . vlan vlan . 0 - STP DISABLED . vlan STP . BPDU STP vlan . 1 - STP LISTENING . STP . vlan BPDU STP . 2 - STP LEARNING . STP . vlan MAC . 3 - STP FORWARDING . vlan . 4 - STP BLOCKING . STP . STP . vlan BPDU STP . mcast_max_groups MAX_GROUPS MDB VLAN . VLAN . mcast_vlan_snooping ip link . mcast_router MULTICAST_ROUTER vlan 0 2 . vlan . MULTICAST_ROUTER : 0 - . 1 - (). 2 - vlan . 3 - vlan . . neigh_suppress on neigh_suppress off (arp nd) VLAN . . neigh_vlan_suppress bridge link . neigh_forward_grat on neigh_forward_grat off ARP (gratuitous ARP) (unsolicited Neighbor Advertisement) VLAN . gratuitous ARP unsolicited NA . on . neigh_vlan_suppress bridge link . bridge vlan show - vlan VLAN . -details (verbose) . vlan . -statistics vlan . bridge vlan tunnelshow - vlan vlan . bridge vlan global set - vlan vlan . dev NAME vlan . . vid VID VLAN vlan . mcast_snooping MULTICAST_SNOOPING (multicast snooping) VLAN VLAN (MULTICAST_SNOOPING > 0) (MULTICAST_SNOOPING == 0). (on) . mcast_querier MULTICAST_QUERIER (MULTICAST_QUERIER > 0) (MULTICAST_QUERIER == 0) IGMP/MLD . . mcast_igmp_version IGMP_VERSION IGMP. 2 . mcast_mld_version MLD_VERSION MLD. 1 . mcast_last_member_count LAST_MEMBER_COUNT "leave" . 2 . mcast_last_member_interval LAST_MEMBER_INTERVAL "leave". mcast_startup_query_count STARTUP_QUERY_COUNT . 2 . mcast_startup_query_interval STARTUP_QUERY_INTERVAL . mcast_membership_interval MEMBERSHIP_INTERVAL . mcast_querier_interval QUERIER_INTERVAL . ( mcast_querier ). mcast_query_interval QUERY_INTERVAL . mcast_query_response_interval QUERY_RESPONSE_INTERVAL / IGMP/MLD . msti MSTI VLAN (MSTI) . bridge vlan global show - vlan VLAN VLAN . dev DEV VLAN . . vid VID VLAN . vlan . bridge vni - VNI vni VNI vxlan (dst metadata) . vni . bridge vni add - vni vni . dev NAME vni . vni VNI VNI vni . remote IPADDR IP VXLAN . group . group IPADDR IP VNI . bridge vni del - vni vni . bridge vni add . bridge vni show - vni vni . -statistics vni . dev NAME vni vxlan . bridge monitor - (state monitoring) bridge . monitor : bridge monitor [ all | OBJECT-LIST ] OBJECT-LIST . link fdb vlan mdb . file bridge RTNETLINK (dump) . RTNETLINK RTNETLINK . (NOTES) 3.0 . . netlink . . add/delete/modify . (SEE ALSO) ip(8) (BUGS) : (AUTHOR) Stephen Hemminger . iproute2 1 August 2012 BRIDGE(8)