diff options
author | Luca Boccassi <bluca@debian.org> | 2022-09-29 22:41:55 +0100 |
---|---|---|
committer | Luca Boccassi <luca.boccassi@gmail.com> | 2022-09-30 13:25:31 +0100 |
commit | ace212f577572bcbab5a464d13bf09418a6e7fa4 (patch) | |
tree | d5b2d5a295ce3de9405f6af4b9dd864f97e5a914 /man | |
parent | e638a062e8fbbf3a838af671693e5d0d94b575ef (diff) | |
download | systemd-ace212f577572bcbab5a464d13bf09418a6e7fa4.tar.gz |
portablectl: add --force attach/detach
Allows to skip check that ensures units must not be running.
I have a use case that would use reattach, except the orchestrator
is using a non-standard versioning scheme, so image matching cannot
work. As a workaround, need to be able to detach and then attach
manually, without stopping the units to avoid extended downtimes
and loss of FD store.
Diffstat (limited to 'man')
-rw-r--r-- | man/org.freedesktop.portable1.xml | 5 | ||||
-rw-r--r-- | man/portablectl.xml | 7 |
2 files changed, 11 insertions, 1 deletions
diff --git a/man/org.freedesktop.portable1.xml b/man/org.freedesktop.portable1.xml index 0007e0c2de..0e926fe850 100644 --- a/man/org.freedesktop.portable1.xml +++ b/man/org.freedesktop.portable1.xml @@ -307,10 +307,13 @@ node /org/freedesktop/portable1 { <para>The <function>AttachImageWithExtensions()</function>, <function>DetachImageWithExtensions()</function> and <function>ReattachImageWithExtensions()</function> methods take in options as flags instead of - booleans to allow for extendability, defined as follows:</para> + booleans to allow for extendability. <varname>SD_SYSTEMD_PORTABLE_FORCE</varname> will cause + safety checks that ensure the units are not running while the new image is attached or detached + to be skipped. They are defined as follows:</para> <programlisting> #define SD_SYSTEMD_PORTABLE_RUNTIME (UINT64_C(1) << 0) +#define SD_SYSTEMD_PORTABLE_FORCE (UINT64_C(1) << 1) </programlisting> </refsect2> diff --git a/man/portablectl.xml b/man/portablectl.xml index ed2089c63a..64927a2fe6 100644 --- a/man/portablectl.xml +++ b/man/portablectl.xml @@ -374,6 +374,13 @@ and detaching.</para></listitem> </varlistentry> + <varlistentry> + <term><option>--force</option></term> + + <listitem><para>Skip safety checks and attach or detach images (with extensions) without first ensuring + that the units are not running.</para></listitem> + </varlistentry> + <xi:include href="user-system-options.xml" xpointer="host" /> <xi:include href="user-system-options.xml" xpointer="machine" /> |