man: clarify requirements for BridgeVLAN to work

This commit is contained in:
dgengtek
2025-10-31 15:26:14 +09:00
committed by Yu Watanabe
parent 404d9bfb62
commit 4207abb6e1
+8 -6
View File
@@ -6347,15 +6347,17 @@ ServerAddress=192.168.0.1/24</programlisting>
<refsect1>
<title>[BridgeVLAN] Section Options</title>
<para>
The [BridgeVLAN] section manages the VLAN ID configurations of a bridge master or port, and accepts the
following keys. To make the settings in this section take an effect,
The [BridgeVLAN] section manages the VLAN ID configuration of a bridge master or enslaved device.
To make the settings in this section take an effect,
<varname>VLANFiltering=</varname> option has to be enabled on the bridge master, see the [Bridge]
section in
<citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
If at least one valid settings specified in this section in a .network file for an interface, all
assigned VLAN IDs on the interface that are not configured in the .network file will be removed. If
<citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>, and
each enslaved device needs to define the relevant VLAN IDs in its own [BridgeVLAN] section, which it
has in common with the bridge master.
All assigned VLAN IDs on the interface that are not configured in the .network file will be removed. If
VLAN IDs on an interface need to be managed by other tools, then the settings in this section cannot
be used in the matching .network file.
be used in the matching .network file and <varname>VLANFiltering=</varname> needs to be disabled on
the bridge master.
</para>
<variablelist class='network-directives'>