summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2024-09-11 17:11:45 +0200
committerDaan De Meyer <daan.j.demeyer@gmail.com>2024-09-11 18:45:05 +0200
commitc64ddefd5ce4ffaa286d2a5fe2c3d10d68279053 (patch)
tree8c3e59cbab6c411f2029600e69e460a1f84d610d /man
parentrepart: Add missing parameter comment (diff)
downloadsystemd-c64ddefd5ce4ffaa286d2a5fe2c3d10d68279053.tar.xz
systemd-c64ddefd5ce4ffaa286d2a5fe2c3d10d68279053.zip
repart: Add MakeSymlinks=
Similar to MakeDirectories=, but creates symlinks in the filesystem.
Diffstat (limited to 'man')
-rw-r--r--man/repart.d.xml24
1 files changed, 24 insertions, 0 deletions
diff --git a/man/repart.d.xml b/man/repart.d.xml
index a3c42e15e0..3ffb6aba02 100644
--- a/man/repart.d.xml
+++ b/man/repart.d.xml
@@ -538,6 +538,30 @@
</varlistentry>
<varlistentry>
+ <term><varname>MakeSymlinks=</varname></term>
+
+ <listitem><para>Takes one or more arguments, separated by whitespace, each declaring a symlink to
+ create within the new file system. Each argument is a pair of symlink source and target paths,
+ separated by a colon. This option may be used more than once to create multiple symlinks. When
+ <varname>CopyFiles=</varname> and <varname>MakeSymlinks=</varname> are used together the former is
+ applied first.</para>
+
+ <para>The primary use case for this option is to create symlinks that need to exist before
+ <citerefentry><refentrytitle>systemd-tmpfiles</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ is executed. For example, when using
+ <citerefentry><refentrytitle>systemd-confext</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+ this setting can be used to create symlinks in <filename>/var/lib/extensions.mutable</filename> to
+ redirect writes to mutable confexts to a custom location.</para>
+
+ <para>Consider using
+ <citerefentry><refentrytitle>systemd-tmpfiles</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ with its <option>--image=</option> option to pre-create other symlinks (as well as other inodes) with
+ fine-grained control of ownership, access modes and other file attributes.</para>
+
+ <xi:include href="version-info.xml" xpointer="v257"/></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><varname>Subvolumes=</varname></term>
<listitem><para>Takes one or more absolute paths, separated by whitespace, each declaring a directory