linux-doc.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH V2] Documentation: Improve crash_kexec_post_notifiers description
@ 2024-08-30 18:21 Guilherme G. Piccoli
  2024-09-02  3:05 ` Baoquan He
  2024-09-02  8:23 ` Simon Horman
  0 siblings, 2 replies; 6+ messages in thread
From: Guilherme G. Piccoli @ 2024-08-30 18:21 UTC (permalink / raw)
  To: kexec, linux-doc
  Cc: bhe, vgoyal, dyoung, corbet, linux-kernel, linux-debuggers,
	stephen.s.brennan, kernel, kernel-dev, Guilherme G. Piccoli

Be more clear about the downsides, the upsides (yes, there are some!)
and about code that unconditionally sets that.

Reviewed-by: Stephen Brennan <stephen.s.brennan@oracle.com>
Signed-off-by: Guilherme G. Piccoli <gpiccoli@igalia.com>

---

V2: Some wording improvements from Stephen, thanks!
Also added his review tag.

V1 link: https://lore.kernel.org/r/20240830140401.458542-1-gpiccoli@igalia.com/


 Documentation/admin-guide/kernel-parameters.txt | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt
index efc52ddc6864..351730108c58 100644
--- a/Documentation/admin-guide/kernel-parameters.txt
+++ b/Documentation/admin-guide/kernel-parameters.txt
@@ -913,12 +913,16 @@
 			the parameter has no effect.
 
 	crash_kexec_post_notifiers
-			Run kdump after running panic-notifiers and dumping
-			kmsg. This only for the users who doubt kdump always
-			succeeds in any situation.
-			Note that this also increases risks of kdump failure,
-			because some panic notifiers can make the crashed
-			kernel more unstable.
+			Only jump to kdump kernel after running the panic
+			notifiers and dumping kmsg. This option increases the
+			risks of a kdump failure, since some panic notifiers
+			can make the crashed kernel more unstable. In the
+			configurations where kdump may not be reliable,
+			running the panic notifiers can allow collecting more
+			data on dmesg, like stack traces from other CPUS or
+			extra data dumped by panic_print. Notice that some
+			code enables this option unconditionally, like
+			Hyper-V, PowerPC (fadump) and AMD SEV.
 
 	crashkernel=size[KMG][@offset[KMG]]
 			[KNL,EARLY] Using kexec, Linux can switch to a 'crash kernel'
-- 
2.46.0


^ permalink raw reply related	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2024-09-12  0:54 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-08-30 18:21 [PATCH V2] Documentation: Improve crash_kexec_post_notifiers description Guilherme G. Piccoli
2024-09-02  3:05 ` Baoquan He
2024-09-11 15:09   ` Guilherme G. Piccoli
2024-09-12  0:54     ` Baoquan He
2024-09-02  8:23 ` Simon Horman
2024-09-11 15:10   ` Guilherme G. Piccoli

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).