system/systemd
system/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd synced 2024-07-22 18:55:10 +00:00
Code Issues Actions 7 Packages Projects Releases Wiki Activity

man/systemctl: say that kexec loads the kernel, mention --force

Browse source 
Fixes #24588.
Fixes #15029.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2023-05-30 11:12:26 +02:00
parent df73880106
commit fb12f1404f
1 changed files with 20 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
man/systemctl.xml
View file

@ -1535,13 +1535,27 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
<term><command>kexec</command></term>
<listitem>
<para>Shut down and reboot the system via <command>kexec</command>. This is equivalent to
<command>systemctl start kexec.target --job-mode=replace-irreversibly --no-block</command>. This command is
asynchronous; it will return after the reboot operation is enqueued, without waiting for it to
complete.</para>
<para>Shut down and reboot the system via <command>kexec</command>. 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 <option>--force</option> can be used to continue without a kexec kernel, i.e. to
perform a normal reboot. The final reboot step is equivalent to
<command>systemctl start kexec.target --job-mode=replace-irreversibly --no-block</command>.
</para>
<para>This command honors <option>--force</option> and <option>--when=</option> in a similar way
as <command>halt</command>.</para>
<para>To load a kernel, an enumeration is performed following the
<ulink url="https://uapi-group.org/specifications/specs/boot_loader_specification">Boot Loader Specification</ulink>,
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. <command>bootctl list</command>
may be used to list boot entries, see
<citerefentry><refentrytitle>bootctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
</para>
<para>This command is asynchronous; it will return after the reboot operation is enqueued,
without waiting for it to complete.</para>
<para>This command honors <option>--force</option> and <option>--when=</option> similarly
to <command>halt</command>.</para>
</listitem>
</varlistentry>