diff --git a/man/systemd-sysext.xml b/man/systemd-sysext.xml
index 6bda5f4fc6..e5f2e36899 100644
--- a/man/systemd-sysext.xml
+++ b/man/systemd-sysext.xml
@@ -139,7 +139,7 @@
with newer ones, for example to install a locally compiled development version of some low-level
component over the immutable OS image without doing a full OS rebuild or modifying the nominally
immutable image. (e.g. "install" a locally built package with DESTDIR=/var/lib/extensions/mytest
- make install && systemd-sysext --refresh, making it available in
+ make install && systemd-sysext refresh, making it available in
/usr/ as if it was installed in the OS image itself.) This case works regardless if
the underlying host /usr/ is managed as immutable disk image or is a traditional
package manager controlled (i.e. writable) tree.
@@ -148,12 +148,19 @@
Commands
- The following command switches are understood:
+ The following commands are understood:
-
-
+
+
+ When invoked without any command verb, or when is specified
+ the current merge status is shown, separately for both /usr/ and
+ /opt/.
+
+
+
+ Merges all currently installed system extension images into
/usr/ and /opt/, by overmounting these hierarchies with an
overlayfs file system combining the underlying hierarchies with those included in
@@ -161,22 +168,20 @@
-
-
+ Unmerges all currently installed system extension images from
/usr/ and /opt/, by unmounting the
- overlayfs file systems created by
+ overlayfs file systems created by
prior.
-
-
- A combination of and : if already
+
+ A combination of and : if already
mounted the existing overlayfs instance is unmounted temporarily, and then
replaced by a new version. This command is useful after installing/removing system extension images,
in order to update the overlayfs file system accordingly. If no system extensions
- are installed when this command is executed, the equivalent of is
+ are installed when this command is executed, the equivalent of is
executed, without establishing any new overlayfs instance. Note that currently
there's a brief moment where neither the old nor the new overlayfs file system is
mounted. This implies that all resources supplied by a system extension will briefly disappear — even
@@ -184,8 +189,7 @@
-
-
+ A brief list of installed extension images is shown.
@@ -193,9 +197,6 @@
-
- When invoked without any command switches, the current merge status is shown, separately for both
- /usr/ and /opt/.
@@ -218,6 +219,15 @@
output style, or explicitly disabling JSON output.
+
+
+
+ When merging system extensions into /usr/ and
+ /opt/, ignore version incompatibilities, i.e. force merging regardless of
+ whether the version information included in the extension images matches the host or
+ not.
+
+