From 4207abb6e108ada8b24f2008533090f318b789e4 Mon Sep 17 00:00:00 2001 From: dgengtek Date: Thu, 30 Oct 2025 19:50:11 +0100 Subject: [PATCH] man: clarify requirements for BridgeVLAN to work --- man/systemd.network.xml | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/man/systemd.network.xml b/man/systemd.network.xml index 3e55d040b2f..2d22efd6357 100644 --- a/man/systemd.network.xml +++ b/man/systemd.network.xml @@ -6347,15 +6347,17 @@ ServerAddress=192.168.0.1/24 [BridgeVLAN] Section Options - 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, VLANFiltering= option has to be enabled on the bridge master, see the [Bridge] section in - systemd.netdev5. - 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 + systemd.netdev5, 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 VLANFiltering= needs to be disabled on + the bridge master. -- 2.47.3