bridge: NetworkManager Reference Manual

## bridge bridge — Bridging Settings |

## Properties

Table 18.

Key Name | Value Type | Default Value | Value Description
--- | --- | --- | ---
    ageing-time
    uint32
    300
| The Ethernet MAC address aging time, in seconds.
    forward-delay
    uint32
    15
| The Spanning Tree Protocol (STP) forwarding delay, in seconds.
    group-address
    byte array
| If specified, 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, ie an address of the form 01:80:C2:00:00:0X, with X in [0, 4..F]. If not specified the default value is 01:80:C2:00:00:00.
    group-forward-mask
    uint32
    0
| A mask of group addresses to forward. Usually, group addresses in the range from 01:80:C2:00:00:00 to 01:80:C2:00:00:0F are not forwarded according to standards. This property is a mask of 16 bits, each corresponding to a group address in that range that must be forwarded. The mask can't have bits 0, 1 or 2 set because they are used for STP, MAC pause frames and LACP.
    hello-time
    uint32
    2
| The Spanning Tree Protocol (STP) hello time, in seconds.
    interface-name
    string
| Deprecated in favor of connection.interface-name, but can be used for backward-compatibility with older daemons, to set the bridge's interface name.
    mac-address
    byte array
| If specified, the MAC address of bridge. When creating a new bridge, this MAC address will be set. If this field is left unspecified, the "ethernet.cloned-mac-address" is referred instead to generate the initial MAC address. Note that setting "ethernet.cloned-mac-address" anyway overwrites the MAC address of the bridge later while activating the bridge.
    max-age
    uint32
    20
| The Spanning Tree Protocol (STP) maximum message age, in seconds.
    multicast-hash-max
    uint32
    4096
| Set maximum size of multicast hash table (value must be a power of 2).
    multicast-last-member-count
    uint32
    2
| Set the number of queries the bridge will send before stopping forwarding a multicast group after a "leave" message has been received.
    multicast-last-member-interval
    uint64
    100
| Set interval (in deciseconds) between queries to find remaining members of a group, after a "leave" message is received.
    multicast-membership-interval
    uint64
    26000
| Set delay (in deciseconds) after which the bridge will leave a group, if no membership reports for this group are received.
    multicast-querier
    boolean
    FALSE
| Enable or disable sending of multicast queries by the bridge. If not specified the option is disabled.
    multicast-querier-interval
    uint64
    25500
| If no queries are seen after this delay (in deciseconds) has passed, the bridge will start to send its own queries.
    multicast-query-interval
    uint64
    12500
| Interval (in deciseconds) between queries sent by the bridge after the end of the startup phase.
    multicast-query-response-interval
    uint64
    1000
| Set the Max Response Time/Max Response Delay (in deciseconds) for IGMP/MLD queries sent by the bridge.
    multicast-query-use-ifaddr
    boolean
    FALSE
| If enabled the bridge's own IP address is used as the source address for IGMP queries otherwise the default of 0.0.0.0 is used.
    multicast-router
    string
| Sets bridge's multicast router. Multicast-snooping must be enabled for this option to work. Supported values are: 'auto', 'disabled', 'enabled' to which kernel assigns the numbers 1, 0, and 2, respectively. If not specified the default value is 'auto' (1).
    multicast-snooping
    boolean
    TRUE
| Controls whether IGMP snooping is enabled for this bridge. Note that if snooping was automatically disabled due to hash collisions, the system may refuse to enable the feature until the collisions are resolved.
    multicast-startup-query-count
    uint32
    2
| Set the number of IGMP queries to send during startup phase.
    multicast-startup-query-interval
    uint64
    3125
| Sets the time (in deciseconds) between queries sent out at startup to determine membership information.
    priority
    uint32
    32768
| Sets the Spanning Tree Protocol (STP) priority for this bridge. Lower values are "better"; the lowest priority bridge will be elected the root bridge.
    stp
    boolean
    TRUE
| Controls whether Spanning Tree Protocol (STP) is enabled for this bridge.
    vlan-default-pvid
    uint32
    1
| The default PVID for the ports of the bridge, that is the VLAN id assigned to incoming untagged frames.
    vlan-filtering
    boolean
    FALSE
| Control whether VLAN filtering is enabled on the bridge.
    vlan-protocol
    string
| If specified, the protocol used for VLAN filtering. Supported values are: '802.1Q', '802.1ad'. If not specified the default value is '802.1Q'.
    vlan-stats-enabled
    boolean
    FALSE
| Controls whether per-VLAN stats accounting is enabled.
    vlans
    array of vardict
| Array of bridge VLAN objects. In addition to the VLANs specified here, the bridge will also have the default-pvid VLAN configured by the bridge.vlan-default-pvid property. In nmcli the VLAN list can be specified with the following syntax: $vid [pvid] [untagged] [, $vid [pvid] [untagged]]... where $vid is either a single id between 1 and 4094 or a range, represented as a couple of ids separated by a dash.