From d07fbf22ed1cde2459bf42f94c5debb9e0278c1a Mon Sep 17 00:00:00 2001 From: Yu Watanabe Date: Sun, 24 Nov 2024 00:46:47 +0900 Subject: man: update documentation about basic .netdev file handling Follow-up for #34909 and later PRs. --- man/systemd.netdev.xml | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) (limited to 'man') diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml index aefe89fc16..4e65885295 100644 --- a/man/systemd.netdev.xml +++ b/man/systemd.netdev.xml @@ -34,10 +34,16 @@ for a general description of the syntax. The main Virtual Network Device file must have the extension .netdev; - other extensions are ignored. Virtual network devices are created as soon as networkd is - started. If a netdev with the specified name already exists, networkd will use that as-is rather - than create its own. Note that the settings of the pre-existing netdev will not be changed by - networkd. + other extensions are ignored. Virtual network devices are created as soon as + systemd-networkd is started if possible. If a netdev with the specified name already + exists, systemd-networkd will try to update the config if the kind of the existing + netdev is equivalent to the requested one, otherwise (e.g. when bridge device foo + exists but bonding device with the same name is configured in a .netdev file) use the existing netdev + as-is rather than replacing with the requested netdev. Note, several settings (e.g. vlan ID) cannot be + changed after the netdev is created. To change such settings, it is necessary to first remove the + existing netdev, and then run networkctl reload command or restart + systemd-networkd. See also + networkctl1. The .netdev files are read from the files located in the system network directory /usr/lib/systemd/network and -- cgit v1.2.3