xref: /linux/Documentation/ABI/testing/sysfs-kernel-fadump (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1What:		/sys/kernel/fadump/*
2Date:		Dec 2019
3Contact:	linuxppc-dev@lists.ozlabs.org
4Description:
5		The /sys/kernel/fadump/* is a collection of FADump sysfs
6		file provide information about the configuration status
7		of Firmware Assisted Dump (FADump).
8
9What:		/sys/kernel/fadump/enabled
10Date:		Dec 2019
11Contact:	linuxppc-dev@lists.ozlabs.org
12Description:	read only
13		Primarily used to identify whether the FADump is enabled in
14		the kernel or not.
15User:		Kdump service
16
17What:		/sys/kernel/fadump/registered
18Date:		Dec 2019
19Contact:	linuxppc-dev@lists.ozlabs.org
20Description:	read/write
21		Helps to control the dump collect feature from userspace.
22		Setting 1 to this file enables the system to collect the
23		dump and 0 to disable it.
24User:		Kdump service
25
26What:		/sys/kernel/fadump/release_mem
27Date:		Dec 2019
28Contact:	linuxppc-dev@lists.ozlabs.org
29Description:	write only
30		This is a special sysfs file and only available when
31		the system is booted to capture the vmcore using FADump.
32		It is used to release the memory reserved by FADump to
33		save the crash dump.
34
35What:		/sys/kernel/fadump/mem_reserved
36Date:		Dec 2019
37Contact:	linuxppc-dev@lists.ozlabs.org
38Description:	read only
39		Provide information about the amount of memory reserved by
40		FADump to save the crash dump in bytes.
41
42What:		/sys/kernel/fadump/hotplug_ready
43Date:		Apr 2024
44Contact:	linuxppc-dev@lists.ozlabs.org
45Description:	read only
46		Kdump udev rule re-registers fadump on memory add/remove events,
47		primarily to update the elfcorehdr. This sysfs indicates the
48		kdump udev rule that fadump re-registration is not required on
49		memory add/remove events because elfcorehdr is now prepared in
50		the second/fadump kernel.
51User:		kexec-tools
52
53What:		/sys/kernel/fadump/bootargs_append
54Date:		May 2024
55Contact:	linuxppc-dev@lists.ozlabs.org
56Description:	read/write
57		This is a special sysfs file available to setup additional
58		parameters to be passed to capture kernel.
59