- <para>The <literal>[Bridge]</literal> section only applies for
- netdevs of kind <literal>bridge</literal>, and accepts the
- following keys:</para>
-
- <variablelist class='network-directives'>
- <varlistentry>
- <term><varname>HelloTimeSec=</varname></term>
- <listitem>
- <para>HelloTimeSec specifies the number of seconds between two hello packets
- sent out by the root bridge and the designated bridges. Hello packets are
- used to communicate information about the topology throughout the entire
- bridged local area network.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>MaxAgeSec=</varname></term>
- <listitem>
- <para>MaxAgeSec specifies the number of seconds of maximum message age.
- If the last seen (received) hello packet is more than this number of
- seconds old, the bridge in question will start the takeover procedure
- in attempt to become the Root Bridge itself.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>ForwardDelaySec=</varname></term>
- <listitem>
- <para>ForwardDelaySec specifies the number of seconds spent in each
- of the Listening and Learning states before the Forwarding state is entered.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>AgeingTimeSec=</varname></term>
- <listitem>
- <para>This specifies the number of seconds a MAC Address will be kept in
- the forwarding database after having a packet received from this MAC Address.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>Priority=</varname></term>
- <listitem>
- <para>The priority of the bridge. An integer between 0 and 65535. A lower value
- means higher priority. The bridge having the lowest priority will be elected as root bridge.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>GroupForwardMask=</varname></term>
- <listitem>
- <para>A 16-bit bitmask represented as an integer which allows forwarding of link
- local frames with 802.1D reserved addresses (01:80:C2:00:00:0X). A logical AND
- is performed between the specified bitmask and the exponentiation of 2^X, the
- lower nibble of the last octet of the MAC address. For example, a value of 8
- would allow forwarding of frames addressed to 01:80:C2:00:00:03 (802.1X PAE).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>DefaultPVID=</varname></term>
- <listitem>
- <para>This specifies the default port VLAN ID of a newly attached bridge port.
- Set this to an integer in the range 1–4094 or <literal>none</literal> to disable the PVID.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>MulticastQuerier=</varname></term>
- <listitem>
- <para>Takes a boolean. This setting controls the IFLA_BR_MCAST_QUERIER option in the kernel.
- If enabled, the kernel will send general ICMP queries from a zero source address.
- This feature should allow faster convergence on startup, but it causes some
- multicast-aware switches to misbehave and disrupt forwarding of multicast packets.
- When unset, the kernel's default will be used.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>MulticastSnooping=</varname></term>
- <listitem>
- <para>Takes a boolean. This setting controls the IFLA_BR_MCAST_SNOOPING option in the kernel.
- If enabled, IGMP snooping monitors the Internet Group Management Protocol (IGMP) traffic
- between hosts and multicast routers. When unset, the kernel's default will be used.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>VLANFiltering=</varname></term>
- <listitem>
- <para>Takes a boolean. This setting controls the IFLA_BR_VLAN_FILTERING option in the kernel.
- If enabled, the bridge will be started in VLAN-filtering mode. When unset, the kernel's default will be used.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><varname>STP=</varname></term>
- <listitem>
- <para>Takes a boolean. This enables the bridge's Spanning Tree Protocol (STP).
- When unset, the kernel's default will be used.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ <para>The <literal>[Bridge]</literal> section only applies for
+ netdevs of kind <literal>bridge</literal>, and accepts the
+ following keys:</para>
+
+ <variablelist class='network-directives'>
+ <varlistentry>
+ <term><varname>HelloTimeSec=</varname></term>
+ <listitem>
+ <para>HelloTimeSec specifies the number of seconds between two hello packets
+ sent out by the root bridge and the designated bridges. Hello packets are
+ used to communicate information about the topology throughout the entire
+ bridged local area network.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>MaxAgeSec=</varname></term>
+ <listitem>
+ <para>MaxAgeSec specifies the number of seconds of maximum message age.
+ If the last seen (received) hello packet is more than this number of
+ seconds old, the bridge in question will start the takeover procedure
+ in attempt to become the Root Bridge itself.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>ForwardDelaySec=</varname></term>
+ <listitem>
+ <para>ForwardDelaySec specifies the number of seconds spent in each
+ of the Listening and Learning states before the Forwarding state is entered.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>AgeingTimeSec=</varname></term>
+ <listitem>
+ <para>This specifies the number of seconds a MAC Address will be kept in
+ the forwarding database after having a packet received from this MAC Address.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>Priority=</varname></term>
+ <listitem>
+ <para>The priority of the bridge. An integer between 0 and 65535. A lower value
+ means higher priority. The bridge having the lowest priority will be elected as root bridge.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>GroupForwardMask=</varname></term>
+ <listitem>
+ <para>A 16-bit bitmask represented as an integer which allows forwarding of link
+ local frames with 802.1D reserved addresses (01:80:C2:00:00:0X). A logical AND
+ is performed between the specified bitmask and the exponentiation of 2^X, the
+ lower nibble of the last octet of the MAC address. For example, a value of 8
+ would allow forwarding of frames addressed to 01:80:C2:00:00:03 (802.1X PAE).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>DefaultPVID=</varname></term>
+ <listitem>
+ <para>This specifies the default port VLAN ID of a newly attached bridge port.
+ Set this to an integer in the range 1–4094 or <literal>none</literal> to disable the PVID.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>MulticastQuerier=</varname></term>
+ <listitem>
+ <para>Takes a boolean. This setting controls the IFLA_BR_MCAST_QUERIER option in the kernel.
+ If enabled, the kernel will send general ICMP queries from a zero source address.
+ This feature should allow faster convergence on startup, but it causes some
+ multicast-aware switches to misbehave and disrupt forwarding of multicast packets.
+ When unset, the kernel's default will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>MulticastSnooping=</varname></term>
+ <listitem>
+ <para>Takes a boolean. This setting controls the IFLA_BR_MCAST_SNOOPING option in the kernel.
+ If enabled, IGMP snooping monitors the Internet Group Management Protocol (IGMP) traffic
+ between hosts and multicast routers. When unset, the kernel's default will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>VLANFiltering=</varname></term>
+ <listitem>
+ <para>Takes a boolean. This setting controls the IFLA_BR_VLAN_FILTERING option in the kernel.
+ If enabled, the bridge will be started in VLAN-filtering mode. When unset, the kernel's default will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><varname>STP=</varname></term>
+ <listitem>
+ <para>Takes a boolean. This enables the bridge's Spanning Tree Protocol (STP).
+ When unset, the kernel's default will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>