Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation/ABI: new kexec and kdump sysfs interface

Add an ABI document for following kexec and kdump sysfs interface:

- /sys/kernel/kexec/loaded
- /sys/kernel/kexec/crash_loaded
- /sys/kernel/kexec/crash_size
- /sys/kernel/kexec/crash_elfcorehdr_size
- /sys/kernel/kexec/crash_cma_ranges

Link: https://lkml.kernel.org/r/20251118114507.1769455-4-sourabhjain@linux.ibm.com
Signed-off-by: Sourabh Jain <sourabhjain@linux.ibm.com>
Acked-by: Baoquan He <bhe@redhat.com>
Cc: Aditya Gupta <adityag@linux.ibm.com>
Cc: Dave Young <dyoung@redhat.com>
Cc: Hari Bathini <hbathini@linux.ibm.com>
Cc: Jiri Bohac <jbohac@suse.cz>
Cc: Madhavan Srinivasan <maddy@linux.ibm.com>
Cc: Mahesh J Salgaonkar <mahesh@linux.ibm.com>
Cc: Pingfan Liu <piliu@redhat.com>
Cc: Ritesh Harjani (IBM) <ritesh.list@gmail.com>
Cc: Shivang Upadhyay <shivangu@linux.ibm.com>
Cc: Vivek Goyal <vgoyal@redhat.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>

authored by

Sourabh Jain and committed by
Andrew Morton
fb5c3644 5c991b6d

+61
+61
Documentation/ABI/testing/sysfs-kernel-kexec-kdump
··· 1 + What: /sys/kernel/kexec/* 2 + Date: Nov 2025 3 + Contact: kexec@lists.infradead.org 4 + Description: 5 + The /sys/kernel/kexec/* directory contains sysfs files 6 + that provide information about the configuration status 7 + of kexec and kdump. 8 + 9 + What: /sys/kernel/kexec/loaded 10 + Date: Nov 2025 11 + Contact: kexec@lists.infradead.org 12 + Description: read only 13 + Indicates whether a new kernel image has been loaded 14 + into memory using the kexec system call. It shows 1 if 15 + a kexec image is present and ready to boot, or 0 if none 16 + is loaded. 17 + User: kexec tools, kdump service 18 + 19 + What: /sys/kernel/kexec/crash_loaded 20 + Date: Nov 2025 21 + Contact: kexec@lists.infradead.org 22 + Description: read only 23 + Indicates whether a crash (kdump) kernel is currently 24 + loaded into memory. It shows 1 if a crash kernel has been 25 + successfully loaded for panic handling, or 0 if no crash 26 + kernel is present. 27 + User: Kexec tools, Kdump service 28 + 29 + What: /sys/kernel/kexec/crash_size 30 + Date: Nov 2025 31 + Contact: kexec@lists.infradead.org 32 + Description: read/write 33 + Shows the amount of memory reserved for loading the crash 34 + (kdump) kernel. It reports the size, in bytes, of the 35 + crash kernel area defined by the crashkernel= parameter. 36 + This interface also allows reducing the crashkernel 37 + reservation by writing a smaller value, and the reclaimed 38 + space is added back to the system RAM. 39 + User: Kdump service 40 + 41 + What: /sys/kernel/kexec/crash_elfcorehdr_size 42 + Date: Nov 2025 43 + Contact: kexec@lists.infradead.org 44 + Description: read only 45 + Indicates the preferred size of the memory buffer for the 46 + ELF core header used by the crash (kdump) kernel. It defines 47 + how much space is needed to hold metadata about the crashed 48 + system, including CPU and memory information. This information 49 + is used by the user space utility kexec to support updating the 50 + in-kernel kdump image during hotplug operations. 51 + User: Kexec tools 52 + 53 + What: /sys/kernel/kexec/crash_cma_ranges 54 + Date: Nov 2025 55 + Contact: kexec@lists.infradead.org 56 + Description: read only 57 + Provides information about the memory ranges reserved from 58 + the Contiguous Memory Allocator (CMA) area that are allocated 59 + to the crash (kdump) kernel. It lists the start and end physical 60 + addresses of CMA regions assigned for crashkernel use. 61 + User: kdump service