[PATCH] kexec: update manpage with explicit mention of clean kexec

Hari Bathini hbathini at linux.ibm.com
Sun Sep 10 23:34:08 PDT 2023



On 28/08/23 3:12 pm, Baoquan He wrote:
> On 08/28/23 at 09:48am, Simon Horman wrote:
>> On Mon, Aug 28, 2023 at 11:46:14AM +0530, Hari Bathini wrote:
>>> Any comments on this, please..
>>
>> Hi Hari,
>>
>> Sorry, I had missed this.
>>
>>> On 07/07/23 10:59 am, Hari Bathini wrote:
>>>> While the manpage does mention about kexec boot with a clean shutdown,
>>>> it is not explicit about it. Make it explicit.
>>>>
>>>> Signed-off-by: Hari Bathini <hbathini at linux.ibm.com>
>>>> ---
>>>>    kexec/kexec.8 | 12 ++++++++++--
>>>>    1 file changed, 10 insertions(+), 2 deletions(-)
>>>>
>>>> diff --git a/kexec/kexec.8 b/kexec/kexec.8
>>>> index 3a344c5..87e4ab5 100644
>>>> --- a/kexec/kexec.8
>>>> +++ b/kexec/kexec.8
>>>> @@ -95,8 +95,16 @@ then you would use the following command to load the kernel:
>>>>    .RB "\-\-append=" "root=/dev/hda1" "\ \-\-initrd=" /boot/initrd
>>>>    .RE
>>>>    .PP
>>>> -After this kernel is loaded, it can be booted to at any time using the
>>>> -command:
>>>> +After this kernel is loaded, assuming your Linux distribution supports
>>>> +kexec-based rebooting, it can be booted to, with a clean shutdown, using
>>>> +the command:
>>
>> Perhaps user-space would be better than "your Linux distribution".
>> But perhaps that is just kernel developer speak and makes less
>> sense to others.
> 
> Agree, linux distrobution doesn't make sense here. And since this is a
> kexec man page, does it really need to make this change? We know
> kexec-tools loaded a kernel, we will use kexec-tools to trigger the
> reboot. Wondering why we need to stress distros or kernel or kexec-tools
> supports the kexec-based rebooting. 'with a clean shutdown' seems a
> little helpful though.

Yeah. Users did express that lack of clarity on what is the cleaner
approach to use kexec boot after load. That prompted this patch.
I am ok with "user-space" or "your linux distribution".

Simon, do you want to respin with "user-space" change instead?

Thanks
Hari



More information about the kexec mailing list