From fb12f1404f92f2899682dc6c2bc1bfdd1a2c5950 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Tue, 30 May 2023 11:12:26 +0200 Subject: [PATCH] man/systemctl: say that kexec loads the kernel, mention --force Fixes #24588. Fixes #15029. --- man/systemctl.xml | 26 ++++++++++++++++++++------ 1 file changed, 20 insertions(+), 6 deletions(-) diff --git a/man/systemctl.xml b/man/systemctl.xml index e3776fb2776..e54dd22aaee 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -1535,13 +1535,27 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err kexec - Shut down and reboot the system via kexec. This is equivalent to - systemctl start kexec.target --job-mode=replace-irreversibly --no-block. This command is - asynchronous; it will return after the reboot operation is enqueued, without waiting for it to - complete. + Shut down and reboot the system via kexec. This command will load a + kexec kernel if one wasn't loaded yet or fail. A kernel may be loaded earlier by a separate step, + this is particularly useful if a custom initrd or additional kernel commandline options are + desired. The can be used to continue without a kexec kernel, i.e. to + perform a normal reboot. The final reboot step is equivalent to + systemctl start kexec.target --job-mode=replace-irreversibly --no-block. + - This command honors and in a similar way - as halt. + To load a kernel, an enumeration is performed following the + Boot Loader Specification, + and the default boot entry is loaded. For this step to succeed, the system must be using UEFI + and the boot loader entries must be configured appropriately. bootctl list + may be used to list boot entries, see + bootctl1. + + + This command is asynchronous; it will return after the reboot operation is enqueued, + without waiting for it to complete. + + This command honors and similarly + to halt. -- 2.47.3