From: Zbigniew Jędrzejewski-Szmek Date: Tue, 30 May 2023 09:12:26 +0000 (+0200) Subject: man/systemctl: say that kexec loads the kernel, mention --force X-Git-Tag: v254-rc1~333^2~2 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fb12f1404f92f2899682dc6c2bc1bfdd1a2c5950;p=thirdparty%2Fsystemd.git man/systemctl: say that kexec loads the kernel, mention --force Fixes #24588. Fixes #15029. --- 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.