[PATCH] Document kexec without -e/-l/-f/-p and clarify -f
Bernhard Walle
bwalle at suse.de
Thu May 8 13:04:12 EDT 2008
This patch tries to clarify the manpage in two aspects:
It describes the meaning of kexec without an -e / -l / -f / -p option (i.e.
only with kernel, initrd and command line).
It also documents the difference between -f and normal kexec call better.
I made the patch to clarify the manpage because there was some confusion in
https://bugzilla.novell.com/show_bug.cgi?id=387601.
Signed-off-by: Bernhard Walle <bwalle at suse.de>
---
kexec/kexec.8 | 20 +++++++++++++++++++-
1 file changed, 19 insertions(+), 1 deletion(-)
--- a/kexec/kexec.8
+++ b/kexec/kexec.8
@@ -67,6 +67,17 @@ The optional
.I initrd-image
is the initrd image to be used during boot.
.PP
+It's also possible to invoke
+.B kexec
+without an option parameter. In that case, kexec loads the specified
+kernel and then invokes
+.BR shutdown (1).
+If the shutdown scripts of your Linux distribution support
+kexec-based rebooting, they then call
+.B kexec
+.I -e
+just before actually rebooting the machine. That way, the machine does
+a clean shutdown including all shutdown scripts.
.SH EXAMPLE
.PP
@@ -99,7 +110,14 @@ Run the currently loaded kernel.
.B \-f\ (\-\-force)
Force an immediate
.B kexec
-call, do not call shutdown.
+call, do not call
+.BR shutdown (1)
+(contrary to the default action without any option parameter). This option
+performs the same actions like executing
+.IR -l
+and
+.IR -e
+in one call.
.TP
.B \-h\ (\-\-help)
Open a help file for
More information about the kexec
mailing list