Skip to content

Commit fb5c364

Browse files
sourabhjainsakpm00
authored andcommitted
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>
1 parent 5c991b6 commit fb5c364

1 file changed

Lines changed: 61 additions & 0 deletions

File tree

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
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

0 commit comments

Comments
 (0)