dilim/systemd
1
0 Fork 0
mirror of https://github.com/systemd/systemd.git synced 2026-11-06 05:17:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

man: recommend MatchPattern= suitable for .v/ directories in sysupdate.d(5)

Browse Source 
.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 30218dd84e)
(cherry picked from commit d5b23e2782)
This commit is contained in:
Lennart Poettering authored and Luca Boccassi committed 2026-11-05 14:48:10 +00:00
1 parent 4971827acb
commit 950525d9fa
1 file changed
+15
Download Patch File Download Diff File Expand all files Collapse all files
man/sysupdate.d.xml
+15
View File
@@ -732,6 +732,21 @@
<literal>bar.efi</literal> in directory <literal>foo_1</literal>. Directories in the path will be
created when file is installed. Empty directories will be removed when file is removed.</para>
<para>File and directory targets are a good fit for <literal>.v/</literal> directories, which allow
consumers to automatically pick the newest installed version, see
<citerefentry><refentrytitle>systemd.v</refentrytitle><manvolnum>7</manvolnum></citerefentry>. These
expect a much stricter naming scheme than what <varname>MatchPattern=</varname> permits: the
entries of a directory <filename><replaceable>NAME</replaceable><replaceable>.SUFFIX</replaceable>.v/</filename>
should be named
<filename><replaceable>NAME</replaceable>_<replaceable>VERSION</replaceable><replaceable>.SUFFIX</replaceable></filename>,
optionally with the boot assessment counters appended to the version. Hence, the recommended pattern
for such a target is <literal><replaceable>NAME</replaceable>_@v<replaceable>.SUFFIX</replaceable></literal>
(or <literal><replaceable>NAME</replaceable>_@v+@l-@d<replaceable>.SUFFIX</replaceable></literal> if
boot assessment counters shall be used). For example, for <literal>Path=/var/lib/machines/foobar.raw.v</literal>,
use <literal>MatchPattern=foobar_@v.raw</literal>, and for a <constant>directory</constant> target
with <literal>Path=/var/lib/machines/foobar.v</literal>, use
<literal>MatchPattern=foobar_@v</literal>.</para>
<xi:include href="version-info.xml" xpointer="v251"/></listitem>
</varlistentry>