summaryrefslogtreecommitdiff
path: root/man/machinectl.xml
diff options
context:
space:
mode:
authorMike Yuan <me@yhndnzj.com>2023-01-24 01:20:14 +0800
committerLuca Boccassi <luca.boccassi@gmail.com>2023-01-24 11:09:03 +0000
commitc2434a61f2a7ae2380ec4de0cd7128e3b9bffbac (patch)
tree52e5e5e1527e98d9848f6ff6bf5ef519c7e16bab /man/machinectl.xml
parent425e293427e642a52ee0eb35e830f0301f2f582f (diff)
downloadsystemd-c2434a61f2a7ae2380ec4de0cd7128e3b9bffbac.tar.gz
machinectl: add --now to start/stop containers when enabling/disabling
Closes #26154
Diffstat (limited to 'man/machinectl.xml')
-rw-r--r--man/machinectl.xml17
1 files changed, 16 insertions, 1 deletions
diff --git a/man/machinectl.xml b/man/machinectl.xml
index 9f3e0921a4..2ecbe0f0ab 100644
--- a/man/machinectl.xml
+++ b/man/machinectl.xml
@@ -234,7 +234,11 @@
<citerefentry><refentrytitle>systemd-nspawn</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
This enables or disables <filename>systemd-nspawn@.service</filename>, instantiated for the specified
machine name, similarly to the effect of <command>systemctl enable</command> or <command>systemctl
- disable</command> on the service name.</para></listitem>
+ disable</command> on the service name.</para>
+
+ <para>This command implicitly reloads the system manager configuration after completing the operation.
+ Note that this command does not implicitly start or power off the containers that are being operated on.
+ If this is desired, combine the command with the <option>--now</option> switch.</para></listitem>
</varlistentry>
<varlistentry>
@@ -777,6 +781,17 @@
</varlistentry>
<varlistentry>
+ <term><option>--now</option></term>
+
+ <listitem>
+ <para>When used with <command>enable</command> or <command>disable</command>,
+ the containers will also be started or powered off. The start or poweroff
+ operation is only carried out when the respective enable or disable
+ operation has been successful.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--force</option></term>
<listitem><para>When downloading a container or VM image, and