From 301265ea1075b0fbaa6fb80dfaa4cf6c15d69623 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 19 Jan 2021 19:53:20 +0100 Subject: [PATCH] man: document recent systemd-sysext interface changes --- man/systemd-sysext.xml | 42 ++++++++++++++++++++++++++---------------- 1 file changed, 26 insertions(+), 16 deletions(-) diff --git a/man/systemd-sysext.xml b/man/systemd-sysext.xml index 6bda5f4fc65..e5f2e368998 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. + + -- 2.47.3