From c2434a61f2a7ae2380ec4de0cd7128e3b9bffbac Mon Sep 17 00:00:00 2001
From: Mike Yuan <me@yhndnzj.com>
Date: Tue, 24 Jan 2023 01:20:14 +0800
Subject: machinectl: add --now to start/stop containers when
 enabling/disabling

Closes #26154
---
 man/machinectl.xml | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

(limited to 'man/machinectl.xml')

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>
@@ -776,6 +780,17 @@
         <literal>signature</literal>.</para></listitem>
       </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>
 
-- 
cgit v1.2.1