# Bridge

The `nv unset` commands remove the configuration you set with the equivalent `nv set` commands. This guide only describes an `nv unset` command if it differs from the `nv set` command.

## nv set bridge domain <domain-id>

Configures the bridge.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

## nv set bridge domain <domain-id> ageing

Configures the number of seconds that Cumulus Linux stores MAC addresses in the Ethernet switching table. You can set a value between 0 and 65535. The default setting is 1800 seconds (30 minutes). A value of 0 turns MAC ageing off.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.5.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default ageing 600

## nv set bridge domain <domain-id> dhcp-snoop vlan <vid>

Enables DHCP snooping for IPv4 on a VLAN under a bridge.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.11.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop vlan 10

## nv set bridge domain <domain-id> dhcp-snoop vlan <vid> trust <interface-id>

Configures a trusted interface for IPv4. Cumulus Linux allows DHCP offers from only trusted interfaces to prevent malicious DHCP servers from assigning IPv4 addresses inside the network. The interface must be a member of the bridge you specify.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.
`<interface-id>` | The trusted interface ID.

### Version History

Introduced in Cumulus Linux 5.11.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop vlan 10 trust swp3

## nv set bridge domain <domain-id> dhcp-snoop6 vlan <vid>

Enables DHCP snooping for IPv6 on a VLAN under a bridge.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.11.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop6 vlan 10

## nv set bridge domain <domain-id> dhcp-snoop6 vlan <vid> trust <interface-id>

Configures a trusted interface for IPv6. Cumulus Linux allows DHCP offers from only trusted interfaces to prevent malicious DHCP servers from assigning IPv6 addresses inside the network. The interface must be a member of the bridge you specify.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.
`<interface-id>` | The trusted interface ID.

### Version History

Introduced in Cumulus Linux 5.11.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop6 vlan 10 trust swp3

## nv set bridge domain <domain-id> encap 802.1Q

Configures all interfaces in this bridge domain to use 802.1Q encapsulation.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default encap 802.1Q

## nv set bridge domain <domain-id> mac-address

Configures all interfaces in this bridge domain to use this MAC address.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default mac-address 00:00:00:00:00:10

## nv set bridge domain <domain-id> multicast

Configures multicast on the bridge.

## nv set bridge domain <domain-id> multicast snooping

Configures IGMP and MLD snooping to prevent hosts on a local network from receiving traffic for a multicast group they have not explicitly joined. IGMP snooping is for IPv4 environments and MLD snooping is for IPv6 environments.

## nv set bridge domain <domain-id> multicast snooping state

Enables and disables IGMP and MLD snooping. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default multicast snooping state enabled

## nv set bridge domain <domain-id> multicast snooping querier state

Enables and disables the IGMP and MLD multicast querier. The default setting is `disabled`.

Without a multicast router, a single switch in an IP subnet can coordinate multicast traffic flows. This switch is the querier or the designated router. The querier generates query messages to check group membership, and processes membership reports and leave messages.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default multicast snooping querier state enabled

## nv set bridge domain <domain-id> stp force-protocol-version

Configures the switch to send BPDU type 0 STP configuration BPDUs. By default, the switch sends RSTP type 2 BPDUs. You can configure the switch to send BPDU type 0 STP configuration BPDUs when you need to interoperate with other systems.

You can specify either `stp` or `rstp`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.7.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp force-protocol-version stp

## nv set bridge domain <domain-id> stp mode

Configures STP mode on the bridge. You can specify PVRST or RSTP mode. RSTP is the default mode.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp mode pvrst

## nv set bridge domain <domain-id> stp priority

Configures the spanning tree priority. The bridge with the lowest priority is the root bridge. The priority must be a number between 0 and 61440, and must be a multiple of 4096. The default value is 32768.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp priority 8192

## nv set bridge domain <domain-id> stp state

Configures the STP state on the bridge. You can set a value of `up`, or `down`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp state up

## nv set bridge domain <domain-id> stp vlan <vid> bridge-priority

Configures the spanning tree priority for a VLAN when in PVRST mode. You can set a value between 4096 and 61440.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 bridge-priority 4096

## nv set bridge domain <domain-id> stp vlan <vid> hello-time

Configures the hello timer for a VLAN when in PVRST mode. The hello timer sets how often to broadcast hello messages to other switches. You can set a value between 1 and 10 seconds.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 hello-time 4

## nv set bridge domain <domain-id> stp vlan <vid> forward-delay

Configures the forward delay for a VLAN when in PVRST mode. The forward delay sets the delay before changing the spanning tree state from blocking to forwarding. You can set a value between 4 and 30 seconds.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 forward-delay 4

## nv set bridge domain <domain-id> stp vlan <vid> max-age

Configures the max age for a VLAN when in PVRST mode. The max age sets the maximum amount of time STP information is retained before it is discarded. You can set a value between 6 and 40 seconds.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 max-age 6

## nv set bridge domain <domain-id> svi-force-up state

Configures the SVIs in a specific bridge to be perpetually UP. The first time you configure a switch, all southbound bridge ports are down; therefore, by default, all SVIs are also down. You can run this command to force the SVIs in a bridge to always be UP even if all member ports are DOWN, which is beneficial if you want to perform connectivity testing.

You can specify `enabled` or `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.8.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default svi-force-up state enabled

## nv set bridge domain <domain-id> type vlan-aware

Configures the bridge to be VLAN-aware.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default type vlan-aware

## nv set bridge domain <domain-id> untagged

Configures the interfaces on the bridge to be untagged so that they pass traffic for only a single VLAN.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default untagged none

## nv set bridge domain <domain-id> vlan <vid>

Configures the VLAN tag identifier.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan 10

## nv set bridge domain <domain-id> vlan <vid> ptp state

Enables and disables PTP for the specified VLAN. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan vlan10 ptp state enabled

## nv set bridge domain <domain-id> vlan <vid> vni <vni-id>

Maps a VLAN to a VNI.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.
`<vni-id>` | The VXLAN name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10

## nv set bridge domain <domain-id> vlan <vid> vni <vni-id> flooding state

Enables BUM traffic handling for the specified VNI.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.
`<vni-id>` | The VXLAN name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 flooding state enabled

## nv set bridge domain <domain-id> vlan <vid> vni <vni-id> flooding head-end-replication <hrep-id>

Configures replication of BUM traffic where individual copies send to remote destinations.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.
`<vni-id>` | The VXLAN name.
`<hrep-id>` | The IPv4 unicast addresses or `evpn`.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 flooding head-end-replication 10.10.10.2

## nv set bridge domain <domain-id> vlan <vid> vni <vni-id> flooding multicast-group <ipv4-multicast>

Configures BUM traffic to go to the specified multicast group, where receivers who are interested in that group receive the traffic. This requires you to use PIM-SM in the network.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.
`<vni-id>` | The VXLAN name.
`<ipv4-multicast>` | The multicast group.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 flooding multicast-group 224.0.0.10

## nv set bridge domain <domain-id> vlan <vid> vni <vni-id> mac-learning

Enables and disables MAC learning for the VNI. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.
`<vni-id>` | The VXLAN name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 mac-learning enabled

## nv set bridge domain <domain-id> vlan <vid> multicast snooping querier source-ip <source-ip>

Configures the source IP address you want to use to send IGMP MLD queries.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan vlan10 multicast snooping querier source-ip 10.10.10.1

## nv set bridge domain <domain-id> vlan-vni-offset

Configures the VNI offset when mapping VLANs to VNIs automatically. You can set a value between 0 and 16773120. For example, if you specify an offset of 10000, the VNI is the VLAN plus 10000.

### Command Syntax

Syntax | Description
--- | ---
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set bridge domain br_default vlan-vni-offset 10000

## nv set interface <interface-id> bridge domain <domain-id>

Configures the bridged interface domain.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default

## nv set interface <interface-id> bridge domain <domain-id> access

Configures access ports to ignore all tagged packets. You can set a value between 1 and 4094, `none`, or `auto`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default access 10

## nv set interface <interface-id> bridge domain <domain-id> learning

Enables and disables source MAC address learning for this bridged interface.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default learning enabled

## nv set interface <interface-id> bridge domain <domain-id> stp admin-edge

Enables and disables STP PortAdminEdge on the bridged interface. PortAdminEdge is equivalent to the PortFast feature offered by other vendors. It enables or disables the initial edge state of a port in a bridge. All ports with PortAdminEdge on bypass the listening and learning states and go straight to forwarding.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp admin-edge enabled

## nv set interface <interface-id> bridge domain <domain-id> stp auto-edge

Enables and disables STP AutoEdge on the bridged interface. PortAutoEdge is an enhancement to the standard PortAdminEdge (PortFast) mode, which allows for the automatic detection of edge ports. PortAutoEdge enables and disables the auto transition to and from the edge state of a port in a bridge.

When a port with PortAutoEdge receives a BPDU, the port stops being in the edge port state and transitions into a normal STP port. When the interface no longer receives BPDUs, the port becomes an edge port, and transitions through the discarding and learning states before it resumes forwarding.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp auto-edge enabled

## nv set interface <interface-id> bridge domain <domain-id> stp bpdu-filter

Enables and disables `bpdufilter` on a bridge domain. When enabled, `bpdufilter` filters BPDUs in both directions.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp bpdu-filter enabled

## nv set interface <interface-id> bridge domain <domain-id> stp bpdu-guard

Enables and disables BPDU guard on the bridged interface to protect the spanning tree topology from an unauthorized device affecting the forwarding path. For example, if you add a new host to an access port off a leaf switch and the host sends an STP BPDU, BPDU guard protects against undesirable topology changes in the environment.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp bpdu-guard enabled

## nv set interface <interface-id> bridge domain <domain-id> stp network

Enables and disables bridge assurance capability for a bridged port.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp network enabled

## nv set interface <interface-id> bridge domain <domain-id> stp restrrole

Enables and disables STP restricted role for the bridged port.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp restrrole enabled

## nv set interface <interface-id> bridge domain <domain-id> stp vlan <vid> priority

Configures the interface port priority for a VLAN. You can specify a priority between 0 and 240; the value must be a multiple of 16.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp vlan 10 priority 240

## nv set interface <interface-id> bridge domain <domain-id> stp vlan <vid> path-cost

Configures the interface path cost for a VLAN to influence the spanning tree forwarding path. You can specify a path cost between 1 and 200000000.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp vlan 10 path-cost 4000

## nv set interface <interface-id> bridge domain <domain-id> stp path-cost

Configures the path cost for an interface in the bridge to influence the spanning tree forwarding path. You can specify a value between 1 and 200000000.

For PVRST mode, the port cost for a VLAN takes precedence over the cost for a port. If you do not configure the port cost for a VLAN, Cumulus Linux applies the port cost to all the interfaces in the VLAN. If you do not configure either the port cost for a VLAN or the cost for a port, Cumulus Linux bases the port cost on the link speed.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default stp path-cost 4000

## nv set interface <interface-id> bridge domain <domain-id> untagged

Configures the VLAN in which untagged packets ingress this bridged interface. Egress packets are always tagged. You can set a value between 1 and 4094, `none`, or `auto`. If you specify `none`, the switch drops untagged packets.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default untagged none

## nv set interface <interface-id> bridge domain <domain-id> vlan <vid>

Configures a VLAN for the bridged interface.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-id>` | The bridge name.
`<vlan-id>` | The VLAN name.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 bridge domain default vlan 10

## nv set system global svi-force-up state

Configures all SVIs in all bridges on the switch to be perpetually UP. The first time you configure a switch, all southbound bridge ports are down; therefore, by default, all SVIs are also down. You can run this command to force all SVIs on all bridges to always be UP even when all member ports are DOWN, which is beneficial if you want to perform connectivity testing.

You can specify `enabled` or `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Version History

Introduced in Cumulus Linux 5.8.0

### Example

    cumulus@switch:~$ nv set system global svi-force-up enable on