diff --git a/man/systemd-sysext.xml b/man/systemd-sysext.xml
index e086796411..df5dcafbd1 100644
--- a/man/systemd-sysext.xml
+++ b/man/systemd-sysext.xml
@@ -221,21 +221,26 @@
The following modes are supported:
- : Force immutable mode even if write routing
- directories exist below /var/lib/extensions.mutable/.
- This is the default.
- : Automatic mode. Mutability is disabled by default
- and only enabled if a corresponding write routing directory exists below
- /var/lib/extensions.mutable/.
+ : Force immutable mode even if write routing directories exist
+ below /var/lib/extensions.mutable/. This is the default.
+ : Automatic mode. Mutability is disabled by default and only
+ enabled if a corresponding write routing directory exists below
+ /var/lib/extensions.mutable/.: Force mutable mode and automatically create write routing
- directories below /var/lib/extensions.mutable/ when required.
+ directories below /var/lib/extensions.mutable/ when required.: Force immutable mode like above, but
- merge the contents of directories below /var/lib/extensions.mutable/ into the host
- file system.
+ merge the contents of directories below /var/lib/extensions.mutable/ into the host
+ file system.
+ : Force mutable mode like above, but
+ instead of using write routing directory below /var/lib/extensions.mutable/,
+ systemd-sysext will use empty ephemeral directories. This means that the
+ modifications made in the merged hierarchies will be gone when the hierarchies are
+ unmerged.
See "Options" below on specifying modes using the command line option.
- Mutable mode routes writes to subdirectories in /var/lib/extensions.mutable/.
+ With exception of the ephemeral mode, the mutable mode routes writes to subdirectories in
+ /var/lib/extensions.mutable/.
Writes to /usr/ are directed to /var/lib/extensions.mutable/usr/,
writes to /opt/ are directed to /var/lib/extensions.mutable/opt/, and
@@ -253,10 +258,11 @@
to route writes back to the original base directory hierarchy.
- Alternatively, a temporary file system may be mounted to
+ Alternatively, a temporary file system may be mounted to
/var/lib/extensions.mutable/, or symlinks in
- /var/lib/extensions.mutable/ may point to sub-directories on a temporary
- file system (e.g. below /tmp/) to only allow ephemeral changes.
+ /var/lib/extensions.mutable/ may point to sub-directories on a temporary file system
+ (e.g. below /tmp/) to only allow ephemeral changes. Note that this is not the same
+ as ephemeral mode, because the temporary file system will still exist after unmerging.
@@ -403,6 +409,14 @@
/var/lib/extensions.mutable/ also merged into the host file system.
+
+
+
+ force mutable mode, but with contents of write routing directories in
+ /var/lib/extensions.mutable/ being ignored, and modifications of the host
+ file system being discarded after unmerge.
+
+