diff --git a/man/systemd-networkd.service.xml b/man/systemd-networkd.service.xml
index 2ded90f0f3..b3913004e8 100644
--- a/man/systemd-networkd.service.xml
+++ b/man/systemd-networkd.service.xml
@@ -33,12 +33,16 @@
manages networks. It detects and configures network devices as
they appear, as well as creating virtual network devices.
- To configure low-level link settings independently of
- networks, see
- systemd.link5.
+ Certain low-level settings of physical network devices (e.g. device
+ names and altnames) as well as the creation of SR-IOV virtual functions on
+ physical network interfaces may be managed by
+ systemd-udevd8
+ according to the contents of
+ systemd.link5
+ files.
- systemd-networkd will create network devices based
- on the configuration in
+ systemd-networkd will create "virtual" network
+ devices (e.g. bridges and tunnels) based on the configuration in
systemd.netdev5
files, respecting the [Match] sections in those files.
@@ -47,10 +51,10 @@
with an appropriate [Match] section, see
systemd.network5.
For those links, it will flush existing network addresses and routes when
- bringing up the device. Any links not matched by one of the
- .network files will be ignored. It is also possible to
- explicitly tell systemd-networkd to ignore a link by
- using Unmanaged=yes option, see
+ bringing up the device (except when directed not to). Any links not matched
+ by one of the .network files will be ignored. It is
+ also possible to explicitly tell systemd-networkd to
+ ignore a link by using the Unmanaged=yes option, see
systemd.network5.
diff --git a/man/systemd.link.xml b/man/systemd.link.xml
index 86507d3e3a..7643430549 100644
--- a/man/systemd.link.xml
+++ b/man/systemd.link.xml
@@ -33,6 +33,11 @@
systemd.syntax7 for a
general description of the syntax.
+ Note that some distributions may incorporate .link files in their early boot
+ facilities (e.g. by including copies of the .link files in initramfs). As such it
+ may be necessary to take manual steps to ensure that any local changes are consistent with early-boot
+ storage facilities. The relevant distribution-specific documentation should be consulted.
+
The .link files are read from the files located in the system network
directory /usr/lib/systemd/network and
/usr/local/lib/systemd/network
diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 98df365f1b..3129c1e37d 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -37,6 +37,14 @@
The main network file must have the extension .network; other
extensions are ignored. Networks are applied to links whenever the links appear.
+ Note that not all settings and configurations can be made with .network
+ files, and that it may be necessary to use
+ systemd.link5)
+ or
+ systemd.netdev5)
+ files in conjuction with .network files when working with physical and virtual
+ network devices respectively.
+
The .network files are read from the files located in the system network
directories /usr/lib/systemd/network and
/usr/local/lib/systemd/network