From: Yu Watanabe Date: Sat, 23 Nov 2024 15:46:47 +0000 (+0900) Subject: man: update documentation about basic .netdev file handling X-Git-Tag: v257-rc3~27^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F35326%2Fhead;p=thirdparty%2Fsystemd.git man: update documentation about basic .netdev file handling Follow-up for #34909 and later PRs. --- diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml index aefe89fc165..4e65885295a 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