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