From d5b23e2782ae8289e22fb2eccbbcb95ae2ccfb66 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Wed, 28 Oct 2026 22:50:35 +0100 Subject: [PATCH] man: recommend MatchPattern= suitable for .v/ directories in sysupdate.d(5) .v/ directories enforce a very specific naming scheme for their entries, while MatchPattern= is a lot more flexible. But the two are designed to be used together, hence help the reader to pick a matching pattern. (cherry picked from commit 30218dd84e8a1155d3e5c2cf2f7b8ee2076907f9) --- man/sysupdate.d.xml | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/man/sysupdate.d.xml b/man/sysupdate.d.xml index af415ed7fa9..4e42745f4ce 100644 --- a/man/sysupdate.d.xml +++ b/man/sysupdate.d.xml @@ -755,6 +755,21 @@ bar.efi in directory foo_1. Directories in the path will be created when file is installed. Empty directories will be removed when file is removed. + File and directory targets are a good fit for .v/ directories, which allow + consumers to automatically pick the newest installed version, see + systemd.v7. These + expect a much stricter naming scheme than what MatchPattern= permits: the + entries of a directory NAME.SUFFIX.v/ + should be named + NAME_VERSION.SUFFIX, + optionally with the boot assessment counters appended to the version. Hence, the recommended pattern + for such a target is NAME_@v.SUFFIX + (or NAME_@v+@l-@d.SUFFIX if + boot assessment counters shall be used). For example, for Path=/var/lib/machines/foobar.raw.v, + use MatchPattern=foobar_@v.raw, and for a directory target + with Path=/var/lib/machines/foobar.v, use + MatchPattern=foobar_@v. +