From: Sourabh Jain <sourabhjain@linux.ibm.com> To: mpe@ellerman.id.au Cc: mahesh@linux.vnet.ibm.com, hbathini@linux.ibm.com, linux-kernel@vger.kernel.org, linuxppc-dev@ozlabs.org, corbet@lwn.net, linux-doc@vger.kernel.org, Sourabh Jain <sourabhjain@linux.ibm.com> Subject: [PATCH v3 3/4] Documentation/ABI: mark /sys/kernel/fadump_* sysfs files deprecated Date: Sat, 9 Nov 2019 17:53:38 +0530 [thread overview] Message-ID: <20191109122339.20484-4-sourabhjain@linux.ibm.com> (raw) In-Reply-To: <20191109122339.20484-1-sourabhjain@linux.ibm.com> The /sys/kernel/fadump_* sysfs files are replicated under /sys/kernel/fadump/ directory. But we need to keep the old sysfs files to maintain the backward compatibility. The sysfs files are scheduled to remove by 2021. Signed-off-by: Sourabh Jain <sourabhjain@linux.ibm.com> --- .../sysfs-kernel-fadump_enabled | 3 +++ .../sysfs-kernel-fadump_registered | 3 +++ .../sysfs-kernel-fadump_release_mem | 3 +++ .../sysfs-kernel-fadump_release_opalcore | 2 ++ Documentation/powerpc/firmware-assisted-dump.rst | 15 +++++++++++++-- 5 files changed, 24 insertions(+), 2 deletions(-) rename Documentation/ABI/{testing => obsolete}/sysfs-kernel-fadump_enabled (67%) rename Documentation/ABI/{testing => obsolete}/sysfs-kernel-fadump_registered (72%) rename Documentation/ABI/{testing => obsolete}/sysfs-kernel-fadump_release_mem (74%) rename Documentation/ABI/{testing => removed}/sysfs-kernel-fadump_release_opalcore (82%) diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_enabled b/Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled similarity index 67% rename from Documentation/ABI/testing/sysfs-kernel-fadump_enabled rename to Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled index f73632b1c006..96f49f979e9c 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_enabled +++ b/Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled @@ -1,3 +1,6 @@ +This ABI is deprecated and will be removed after 2021. It is replaced +with /sys/kernel/fadump/enabled. + What: /sys/kernel/fadump_enabled Date: Feb 2012 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_registered b/Documentation/ABI/obsolete/sysfs-kernel-fadump_registered similarity index 72% rename from Documentation/ABI/testing/sysfs-kernel-fadump_registered rename to Documentation/ABI/obsolete/sysfs-kernel-fadump_registered index dcf925e53f0f..11ab41c673de 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_registered +++ b/Documentation/ABI/obsolete/sysfs-kernel-fadump_registered @@ -1,3 +1,6 @@ +This ABI is deprecated and will be removed after 2021. It is replaced +with /sys/kernel/fadump/registered. + What: /sys/kernel/fadump_registered Date: Feb 2012 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_release_mem b/Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem similarity index 74% rename from Documentation/ABI/testing/sysfs-kernel-fadump_release_mem rename to Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem index 9c20d64ab48d..69308b28cb0d 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_release_mem +++ b/Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem @@ -1,3 +1,6 @@ +This ABI is deprecated and will be removed after 2021. It is replaced +with /sys/kernel/fadump/release_mem. + What: /sys/kernel/fadump_release_mem Date: Feb 2012 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_release_opalcore b/Documentation/ABI/removed/sysfs-kernel-fadump_release_opalcore similarity index 82% rename from Documentation/ABI/testing/sysfs-kernel-fadump_release_opalcore rename to Documentation/ABI/removed/sysfs-kernel-fadump_release_opalcore index 53313c1d4e7a..fe42956a3f41 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_release_opalcore +++ b/Documentation/ABI/removed/sysfs-kernel-fadump_release_opalcore @@ -1,3 +1,5 @@ +This ABI is moved to /sys/kernel/fadump/release_opalcore. + What: /sys/kernel/fadump_release_opalcore Date: Sep 2019 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/powerpc/firmware-assisted-dump.rst b/Documentation/powerpc/firmware-assisted-dump.rst index 0455a78486d5..fc7b06408cea 100644 --- a/Documentation/powerpc/firmware-assisted-dump.rst +++ b/Documentation/powerpc/firmware-assisted-dump.rst @@ -283,14 +283,25 @@ Here is the list of files under kernel sysfs: enhanced to use this interface to release the memory reserved for dump and continue without 2nd reboot. - /sys/kernel/fadump_release_opalcore +Note: /sys/kernel/fadump_release_opalcore sysfs has moved to + /sys/kernel/fadump/release_opalcore. + + /sys/kernel/fadump/release_opalcore This file is available only on OPAL based machines when FADump is active during capture kernel. This is used to release the memory used by the kernel to export /sys/firmware/opal/core file. To release this memory, echo '1' to it: - echo 1 > /sys/kernel/fadump_release_opalcore + echo 1 > /sys/kernel/fadump/release_opalcore + +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.17.2
WARNING: multiple messages have this Message-ID (diff)
From: Sourabh Jain <sourabhjain@linux.ibm.com> To: mpe@ellerman.id.au Cc: corbet@lwn.net, mahesh@linux.vnet.ibm.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Sourabh Jain <sourabhjain@linux.ibm.com>, linuxppc-dev@ozlabs.org, hbathini@linux.ibm.com Subject: [PATCH v3 3/4] Documentation/ABI: mark /sys/kernel/fadump_* sysfs files deprecated Date: Sat, 9 Nov 2019 17:53:38 +0530 [thread overview] Message-ID: <20191109122339.20484-4-sourabhjain@linux.ibm.com> (raw) In-Reply-To: <20191109122339.20484-1-sourabhjain@linux.ibm.com> The /sys/kernel/fadump_* sysfs files are replicated under /sys/kernel/fadump/ directory. But we need to keep the old sysfs files to maintain the backward compatibility. The sysfs files are scheduled to remove by 2021. Signed-off-by: Sourabh Jain <sourabhjain@linux.ibm.com> --- .../sysfs-kernel-fadump_enabled | 3 +++ .../sysfs-kernel-fadump_registered | 3 +++ .../sysfs-kernel-fadump_release_mem | 3 +++ .../sysfs-kernel-fadump_release_opalcore | 2 ++ Documentation/powerpc/firmware-assisted-dump.rst | 15 +++++++++++++-- 5 files changed, 24 insertions(+), 2 deletions(-) rename Documentation/ABI/{testing => obsolete}/sysfs-kernel-fadump_enabled (67%) rename Documentation/ABI/{testing => obsolete}/sysfs-kernel-fadump_registered (72%) rename Documentation/ABI/{testing => obsolete}/sysfs-kernel-fadump_release_mem (74%) rename Documentation/ABI/{testing => removed}/sysfs-kernel-fadump_release_opalcore (82%) diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_enabled b/Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled similarity index 67% rename from Documentation/ABI/testing/sysfs-kernel-fadump_enabled rename to Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled index f73632b1c006..96f49f979e9c 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_enabled +++ b/Documentation/ABI/obsolete/sysfs-kernel-fadump_enabled @@ -1,3 +1,6 @@ +This ABI is deprecated and will be removed after 2021. It is replaced +with /sys/kernel/fadump/enabled. + What: /sys/kernel/fadump_enabled Date: Feb 2012 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_registered b/Documentation/ABI/obsolete/sysfs-kernel-fadump_registered similarity index 72% rename from Documentation/ABI/testing/sysfs-kernel-fadump_registered rename to Documentation/ABI/obsolete/sysfs-kernel-fadump_registered index dcf925e53f0f..11ab41c673de 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_registered +++ b/Documentation/ABI/obsolete/sysfs-kernel-fadump_registered @@ -1,3 +1,6 @@ +This ABI is deprecated and will be removed after 2021. It is replaced +with /sys/kernel/fadump/registered. + What: /sys/kernel/fadump_registered Date: Feb 2012 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_release_mem b/Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem similarity index 74% rename from Documentation/ABI/testing/sysfs-kernel-fadump_release_mem rename to Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem index 9c20d64ab48d..69308b28cb0d 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_release_mem +++ b/Documentation/ABI/obsolete/sysfs-kernel-fadump_release_mem @@ -1,3 +1,6 @@ +This ABI is deprecated and will be removed after 2021. It is replaced +with /sys/kernel/fadump/release_mem. + What: /sys/kernel/fadump_release_mem Date: Feb 2012 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/ABI/testing/sysfs-kernel-fadump_release_opalcore b/Documentation/ABI/removed/sysfs-kernel-fadump_release_opalcore similarity index 82% rename from Documentation/ABI/testing/sysfs-kernel-fadump_release_opalcore rename to Documentation/ABI/removed/sysfs-kernel-fadump_release_opalcore index 53313c1d4e7a..fe42956a3f41 100644 --- a/Documentation/ABI/testing/sysfs-kernel-fadump_release_opalcore +++ b/Documentation/ABI/removed/sysfs-kernel-fadump_release_opalcore @@ -1,3 +1,5 @@ +This ABI is moved to /sys/kernel/fadump/release_opalcore. + What: /sys/kernel/fadump_release_opalcore Date: Sep 2019 Contact: linuxppc-dev@lists.ozlabs.org diff --git a/Documentation/powerpc/firmware-assisted-dump.rst b/Documentation/powerpc/firmware-assisted-dump.rst index 0455a78486d5..fc7b06408cea 100644 --- a/Documentation/powerpc/firmware-assisted-dump.rst +++ b/Documentation/powerpc/firmware-assisted-dump.rst @@ -283,14 +283,25 @@ Here is the list of files under kernel sysfs: enhanced to use this interface to release the memory reserved for dump and continue without 2nd reboot. - /sys/kernel/fadump_release_opalcore +Note: /sys/kernel/fadump_release_opalcore sysfs has moved to + /sys/kernel/fadump/release_opalcore. + + /sys/kernel/fadump/release_opalcore This file is available only on OPAL based machines when FADump is active during capture kernel. This is used to release the memory used by the kernel to export /sys/firmware/opal/core file. To release this memory, echo '1' to it: - echo 1 > /sys/kernel/fadump_release_opalcore + echo 1 > /sys/kernel/fadump/release_opalcore + +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.17.2
next prev parent reply other threads:[~2019-11-09 12:24 UTC|newest] Thread overview: 23+ messages / expand[flat|nested] mbox.gz Atom feed top 2019-11-09 12:23 [PATCH v3 0/4] reorganize and add FADump sysfs files Sourabh Jain 2019-11-09 12:23 ` Sourabh Jain 2019-11-09 12:23 ` [PATCH v3 1/4] Documentation/ABI: add ABI documentation for /sys/kernel/fadump_* Sourabh Jain 2019-11-09 12:23 ` Sourabh Jain 2019-11-09 12:23 ` [PATCH v3 2/4] powerpc/fadump: reorganize /sys/kernel/fadump_* sysfs files Sourabh Jain 2019-11-09 12:23 ` Sourabh Jain 2019-11-09 12:59 ` Michal Suchánek 2019-11-09 12:59 ` Michal Suchánek 2019-11-16 14:37 ` Sourabh Jain 2019-11-16 14:37 ` Sourabh Jain 2019-11-24 18:40 ` Michal Suchánek 2019-11-24 18:40 ` Michal Suchánek 2019-11-27 4:54 ` Sourabh Jain 2019-11-27 4:54 ` Sourabh Jain 2019-12-03 11:20 ` Sourabh Jain 2019-12-03 11:20 ` Sourabh Jain 2019-11-23 11:21 ` kbuild test robot 2019-11-23 11:21 ` kbuild test robot 2019-11-23 11:21 ` kbuild test robot 2019-11-09 12:23 ` Sourabh Jain [this message] 2019-11-09 12:23 ` [PATCH v3 3/4] Documentation/ABI: mark /sys/kernel/fadump_* sysfs files deprecated Sourabh Jain 2019-11-09 12:23 ` [PATCH v3 4/4] powerpc/fadump: sysfs for fadump memory reservation Sourabh Jain 2019-11-09 12:23 ` Sourabh Jain
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=20191109122339.20484-4-sourabhjain@linux.ibm.com \ --to=sourabhjain@linux.ibm.com \ --cc=corbet@lwn.net \ --cc=hbathini@linux.ibm.com \ --cc=linux-doc@vger.kernel.org \ --cc=linux-kernel@vger.kernel.org \ --cc=linuxppc-dev@ozlabs.org \ --cc=mahesh@linux.vnet.ibm.com \ --cc=mpe@ellerman.id.au \ /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: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.