From cd7264705d2ce59c9a8a2982d9c744faaa3dc490 Mon Sep 17 00:00:00 2001 From: Lianbo Jiang Date: Fri, 11 Dec 2020 11:37:29 +0800 Subject: [PATCH] Doc: improve mkdumprd man page Currently, when generating a kdump initramfs, mkdumprd will determine how much disk space is available, if the dump target's available space is not greater than the total system memory, mkdumprd will print a warning to remind that there might not be enough space to save a vmcore. Some users are complaining that mkdumprd overestimates the needed size. But actually, the warning covers extreme scenarios such as the slab explodes with non-zero data or a full vmcore, etc. Therefore, need to prevent users from having minimum disk space for crash dump. In view of this, add some descriptions to clarify it in mkdumprd man page. Signed-off-by: Lianbo Jiang Acked-by: Kairui Song --- mkdumprd.8 | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/mkdumprd.8 b/mkdumprd.8 index 7faae57..2ac3d5a 100644 --- a/mkdumprd.8 +++ b/mkdumprd.8 @@ -15,7 +15,13 @@ be loaded in the initramfs (based on configuration retrieved from \fI/etc/kdump.conf)\fR \fBmkdumprd\fR add a new \fBdracut\fR module 99kdumpbase and use \fBdracut\fR -utility to generate the initramfs. +utility to generate the initramfs. When generating a kdump initramfs, \fBmkdumprd\fR +will determine how much disk space is available, if the dump target's available +space is not greater than the total system memory, \fBmkdumprd\fR will print a +warning to remind that there might not be enough space to save a vmcore. The +warning covers extreme scenarios such as the slab explodes with non-zero data or +a full vmcore, etc. Therefore, need to prevent users from having minimum disk +space for crash dump. \fBmkdumprd\fR was not intended for casual use outside of the service initialization script for the kdump utility, and should not be run manually. If