Bug#1005282: systemd: [PATCH] document requirement to sync *.link files with initramfs

[Tim Small]

Package: systemd
Version: 257.5-2
Followup-For: Bug #1005282
X-Debbugs-Cc: tim at seoss.co.uk
Control: tags -1 patch


How about this?  I also plan to submit a patch to the upstream
documentation
stating that there may be distro-specific need to keep early boot files
in-sync.

Regards,

Tim.



*** udev-README-patch-for-link-file-initramfs
diff --git a/debian/README.Debian b/debian/README.Debian
index 11f5e32c48..98eab22a11 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -97,6 +97,10 @@ dynamically manage /etc/resolv.conf:
 
 Debian's networkd has been modified to also work with the resolvconf package.
 
+Note that changes to physical network device configurations are commonly made
+using /etc/systemd/network/*.link files. Please see the important note in
+udev.README.Debian regarding changes to .link files on Debian.
+
 KillUserProcesses behavior in Debian
 ====================================
 
diff --git a/debian/udev.README.Debian b/debian/udev.README.Debian
index 97636d6f4a..b952b8189a 100644
--- a/debian/udev.README.Debian
+++ b/debian/udev.README.Debian
@@ -1,6 +1,19 @@
 This documents udev integration Debian specifics. Please see man udev(7) and
 its referenced manpages for general documentation.
 
+Use of .link files in conjunction with systemd-networkd
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When using systemd-networkd it's commonplace to make changes to network
+interface settings using systemd.link(5) files in the /etc/systemd/network
+directory. It should be noted that Debian systems copy .link files info
+initramfs so that they are available at early boot.
+
+Initramfs MUST be updated with "update-iniramfs -u" after any systemd.link
+files changes. Failure to do so will leave outdated link files in the
+initramfs, which may cause various unintended and difficult-to-diagnose
+problems including potential loss of remote access to the host.
+
 Network interface naming
 ~~~~~~~~~~~~~~~~~~~~~~~~
 Since version 197 udev has a builtin persistent name generator which checks