diff options
Diffstat (limited to 'man/systemd.exec.xml')
| -rw-r--r-- | man/systemd.exec.xml | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index 938a3c87a9..84eda5c584 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -201,6 +201,26 @@ </varlistentry> <varlistentry> + <term><varname>RootEphemeral=</varname></term> + + <listitem><para>Takes a boolean argument. If enabled, executed processes will run in an ephemeral + copy of the root directory or root image. The ephemeral copy is placed in + <filename>/var/lib/systemd/ephemeral-trees/</filename> while the service is active and is cleaned up + when the service is stopped or restarted. If <varname>RootDirectory=</varname> is used and the root + directory is a subvolume, the ephemeral copy will be created by making a snapshot of the subvolume. + </para> + + <para>To make sure making ephemeral copies can be made efficiently, the root directory or root image + should be located on the same filesystem as <filename>/var/lib/systemd/ephemeral-trees/</filename>. + When using <varname>RootEphemeral=</varname> with root directories, btrfs should be used as the + filesystem and the root directory should ideally be a subvolume which <command>systemd</command> can + snapshot to make the ephemeral copy. For root images, a filesystem with support for reflinks should + be used to ensure an efficient ephemeral copy.</para> + + <xi:include href="system-only.xml" xpointer="singular"/></listitem> + </varlistentry> + + <varlistentry> <term><varname>RootHash=</varname></term> <listitem><para>Takes a data integrity (dm-verity) root hash specified in hexadecimal, or the path to a file |