From: Sourabh Jain <sourabhjain@linux.ibm.com>
To: linuxppc-dev@lists.ozlabs.org, maddy@linux.ibm.com,
mpe@ellerman.id.au, ritesh.list@gmail.com
Cc: npiggin@gmail.com, chleroy@kernel.org, shivangu@linux.ibm.com,
hbathini@linux.ibm.com, mahesh@linux.ibm.com,
adityag@linux.ibm.com, venkat88@linux.ibm.com,
Sourabh Jain <sourabhjain@linux.ibm.com>
Subject: [PATCH v2 2/2] Documentation/ABI: remove old fadump sysfs doc
Date: Mon, 13 Jul 2026 09:56:35 +0530 [thread overview]
Message-ID: <20260713042636.1599868-3-sourabhjain@linux.ibm.com> (raw)
In-Reply-To: <20260713042636.1599868-1-sourabhjain@linux.ibm.com>
Patch with title "powerpc/fadump: remove old sysfs symlink" removed the
deprecated fadump sysfs. So remove the respective ABI documents.
Additionally remove the reference of old fadump sysfs from fadump
document.
The alternative sysfs is documented at:
Documentation/ABI/testing/sysfs-kernel-fadump
Signed-off-by: Sourabh Jain <sourabhjain@linux.ibm.com>
---
.../ABI/obsolete/sysfs-kernel-fadump_enabled | 9 -----
.../obsolete/sysfs-kernel-fadump_registered | 10 ------
.../obsolete/sysfs-kernel-fadump_release_mem | 10 ------
.../arch/powerpc/firmware-assisted-dump.rst | 33 +++++++------------
4 files changed, 11 insertions(+), 51 deletions(-)
delete mode 100644 Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled
delete mode 100644 Documentation/ABI/obsolete/sysfs-kernel-fadump_registered
delete mode 100644 Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem
diff --git a/Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled b/Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled
deleted file mode 100644
index e9c2de8b3688..000000000000
--- a/Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled
+++ /dev/null
@@ -1,9 +0,0 @@
-This ABI is renamed and moved to a new location /sys/kernel/fadump/enabled.
-
-What: /sys/kernel/fadump_enabled
-Date: Feb 2012
-Contact: linuxppc-dev@lists.ozlabs.org
-Description: read only
- Primarily used to identify whether the FADump is enabled in
- the kernel or not.
-User: Kdump service
diff --git a/Documentation/ABI/obsolete/sysfs-kernel-fadump_registered b/Documentation/ABI/obsolete/sysfs-kernel-fadump_registered
deleted file mode 100644
index dae880b1a5d5..000000000000
--- a/Documentation/ABI/obsolete/sysfs-kernel-fadump_registered
+++ /dev/null
@@ -1,10 +0,0 @@
-This ABI is renamed and moved to a new location /sys/kernel/fadump/registered.
-
-What: /sys/kernel/fadump_registered
-Date: Feb 2012
-Contact: linuxppc-dev@lists.ozlabs.org
-Description: read/write
- Helps to control the dump collect feature from userspace.
- Setting 1 to this file enables the system to collect the
- dump and 0 to disable it.
-User: Kdump service
diff --git a/Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem b/Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem
deleted file mode 100644
index ca2396edb5f1..000000000000
--- a/Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem
+++ /dev/null
@@ -1,10 +0,0 @@
-This ABI is renamed and moved to a new location /sys/kernel/fadump/release_mem.
-
-What: /sys/kernel/fadump_release_mem
-Date: Feb 2012
-Contact: linuxppc-dev@lists.ozlabs.org
-Description: write only
- This is a special sysfs file and only available when
- the system is booted to capture the vmcore using FADump.
- It is used to release the memory reserved by FADump to
- save the crash dump.
diff --git a/Documentation/arch/powerpc/firmware-assisted-dump.rst b/Documentation/arch/powerpc/firmware-assisted-dump.rst
index 7e266e749cd5..717e30e8b6cd 100644
--- a/Documentation/arch/powerpc/firmware-assisted-dump.rst
+++ b/Documentation/arch/powerpc/firmware-assisted-dump.rst
@@ -19,9 +19,9 @@ in production use.
- Unlike phyp dump, userspace tool does not need to refer any sysfs
interface while reading /proc/vmcore.
- Unlike phyp dump, FADump allows user to release all the memory reserved
- for dump, with a single operation of echo 1 > /sys/kernel/fadump_release_mem.
+ for dump, with a single operation of echo 1 > /sys/kernel/fadump/release_mem.
- Once enabled through kernel boot parameter, FADump can be
- started/stopped through /sys/kernel/fadump_registered interface (see
+ started/stopped through /sys/kernel/fadump/registered interface (see
sysfs files section below) and can be easily integrated with kdump
service start/stop init scripts.
@@ -86,13 +86,13 @@ as follows:
network, nas, san, iscsi, etc. as desired.
- Once the userspace tool is done saving dump, it will echo
- '1' to /sys/kernel/fadump_release_mem to release the reserved
+ '1' to /sys/kernel/fadump/release_mem to release the reserved
memory back to general use, except the memory required for
next firmware-assisted dump registration.
e.g.::
- # echo 1 > /sys/kernel/fadump_release_mem
+ # echo 1 > /sys/kernel/fadump/release_mem
Please note that the firmware-assisted dump feature
is only available on POWER6 and above systems on pSeries
@@ -152,7 +152,7 @@ then everything but boot memory size of RAM is reserved during
early boot (See Fig. 2). This area is released once we finish
collecting the dump from user land scripts (e.g. kdump scripts)
that are run. If there is dump data, then the
-/sys/kernel/fadump_release_mem file is created, and the reserved
+/sys/kernel/fadump/release_mem file is created, and the reserved
memory is held.
If there is no waiting dump data, then only the memory required to
@@ -281,7 +281,7 @@ the control files and debugfs file to display memory reserved region.
Here is the list of files under kernel sysfs:
- /sys/kernel/fadump_enabled
+ /sys/kernel/fadump/enabled
This is used to display the FADump status.
- 0 = FADump is disabled
@@ -290,15 +290,15 @@ Here is the list of files under kernel sysfs:
This interface can be used by kdump init scripts to identify if
FADump is enabled in the kernel and act accordingly.
- /sys/kernel/fadump_registered
+ /sys/kernel/fadump/registered
This is used to display the FADump registration status as well
as to control (start/stop) the FADump registration.
- 0 = FADump is not registered.
- 1 = FADump is registered and ready to handle system crash.
- To register FADump echo 1 > /sys/kernel/fadump_registered and
- echo 0 > /sys/kernel/fadump_registered for un-register and stop the
+ To register FADump echo 1 > /sys/kernel/fadump/registered and
+ echo 0 > /sys/kernel/fadump/registered for un-register and stop the
FADump. Once the FADump is un-registered, the system crash will not
be handled and vmcore will not be captured. This interface can be
easily integrated with kdump service start/stop.
@@ -308,13 +308,13 @@ Here is the list of files under kernel sysfs:
This is used to display the memory reserved by FADump for saving the
crash dump.
- /sys/kernel/fadump_release_mem
+ /sys/kernel/fadump/release_mem
This file is available only when FADump is active during
second kernel. This is used to release the reserved memory
region that are held for saving crash dump. To release the
reserved memory echo 1 to it::
- echo 1 > /sys/kernel/fadump_release_mem
+ echo 1 > /sys/kernel/fadump/release_mem
After echo 1, the content of the /sys/kernel/debug/powerpc/fadump_region
file will change to reflect the new memory reservations.
@@ -335,17 +335,6 @@ Note: /sys/kernel/fadump_release_opalcore sysfs has moved to
echo 1 > /sys/firmware/opal/mpipl/release_core
-Note: The following FADump sysfs files are deprecated.
-
-+----------------------------------+--------------------------------+
-| Deprecated | Alternative |
-+----------------------------------+--------------------------------+
-| /sys/kernel/fadump_enabled | /sys/kernel/fadump/enabled |
-+----------------------------------+--------------------------------+
-| /sys/kernel/fadump_registered | /sys/kernel/fadump/registered |
-+----------------------------------+--------------------------------+
-| /sys/kernel/fadump_release_mem | /sys/kernel/fadump/release_mem |
-+----------------------------------+--------------------------------+
Here is the list of files under powerpc debugfs:
(Assuming debugfs is mounted on /sys/kernel/debug directory.)
--
2.52.0
prev parent reply other threads:[~2026-07-13 4:27 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-13 4:26 [PATCH v2 0/2] powerpc/fadump: remove deprecated sysfs compatibility links Sourabh Jain
2026-07-13 4:26 ` [PATCH v2 1/2] powerpc/fadump: remove old sysfs symlink Sourabh Jain
2026-07-13 4:26 ` Sourabh Jain [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260713042636.1599868-3-sourabhjain@linux.ibm.com \
--to=sourabhjain@linux.ibm.com \
--cc=adityag@linux.ibm.com \
--cc=chleroy@kernel.org \
--cc=hbathini@linux.ibm.com \
--cc=linuxppc-dev@lists.ozlabs.org \
--cc=maddy@linux.ibm.com \
--cc=mahesh@linux.ibm.com \
--cc=mpe@ellerman.id.au \
--cc=npiggin@gmail.com \
--cc=ritesh.list@gmail.com \
--cc=shivangu@linux.ibm.com \
--cc=venkat88@linux.ibm.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox