linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] docs: document the sysfs ABI for "nohz_full" and "isolated"
@ 2021-12-01  7:18 Kohei Tarumizu
  2021-12-01  7:34 ` Greg KH
  0 siblings, 1 reply; 3+ messages in thread
From: Kohei Tarumizu @ 2021-12-01  7:18 UTC (permalink / raw)
  To: linux-kernel, riel, mchehab+huawei, will, catalin.marinas,
	gregkh, corbet, ionela.voinescu, pcc, bilbao, matorola, rafael
  Cc: tarumizu.kohei

Add missing documentation of sysfs ABI for "nohz_full" and "isolated".
"nohz_full" was added by commit 6570a9a1ce3a("show nohz_full cpus in
sysfs") and "isolated" was added by commit 59f30abe94bf("show isolated
cpus in sysfs"). However, there is no documentation for these
interface.

Signed-off-by: Kohei Tarumizu <tarumizu.kohei@fujitsu.com>
---
 Documentation/ABI/testing/sysfs-devices-system-cpu | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
index 69c65da16dff..a9d5d87b6a41 100644
--- a/Documentation/ABI/testing/sysfs-devices-system-cpu
+++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
@@ -666,3 +666,16 @@ Description:	Preferred MTE tag checking mode
 		================  ==============================================
 
 		See also: Documentation/arm64/memory-tagging-extension.rst
+
+What:		/sys/devices/system/cpu/nohz_full
+		/sys/devices/system/cpu/isolated
+Date:		Apr 2015
+Contact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
+Description:	information about CPU isolation.
+
+		nohz_full: (RO) the list of CPUs that are in nohz_full mode.
+			   These CPUs are set by boot parameter "nohz_full=".
+
+		isolated: (RO) the list of CPUs that are isolated and don't
+			  participate in load balancing. These CPUs are set by
+			  boot parameter "isolcpus=".
-- 
2.27.0


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [PATCH] docs: document the sysfs ABI for "nohz_full" and "isolated"
  2021-12-01  7:18 [PATCH] docs: document the sysfs ABI for "nohz_full" and "isolated" Kohei Tarumizu
@ 2021-12-01  7:34 ` Greg KH
  2021-12-01 11:21   ` tarumizu.kohei
  0 siblings, 1 reply; 3+ messages in thread
From: Greg KH @ 2021-12-01  7:34 UTC (permalink / raw)
  To: Kohei Tarumizu
  Cc: linux-kernel, riel, mchehab+huawei, will, catalin.marinas,
	corbet, ionela.voinescu, pcc, bilbao, matorola, rafael

On Wed, Dec 01, 2021 at 04:18:52PM +0900, Kohei Tarumizu wrote:
> Add missing documentation of sysfs ABI for "nohz_full" and "isolated".
> "nohz_full" was added by commit 6570a9a1ce3a("show nohz_full cpus in
> sysfs") and "isolated" was added by commit 59f30abe94bf("show isolated
> cpus in sysfs"). However, there is no documentation for these
> interface.
> 
> Signed-off-by: Kohei Tarumizu <tarumizu.kohei@fujitsu.com>
> ---
>  Documentation/ABI/testing/sysfs-devices-system-cpu | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
> index 69c65da16dff..a9d5d87b6a41 100644
> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
> @@ -666,3 +666,16 @@ Description:	Preferred MTE tag checking mode
>  		================  ==============================================
>  
>  		See also: Documentation/arm64/memory-tagging-extension.rst
> +
> +What:		/sys/devices/system/cpu/nohz_full
> +		/sys/devices/system/cpu/isolated
> +Date:		Apr 2015
> +Contact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
> +Description:	information about CPU isolation.
> +
> +		nohz_full: (RO) the list of CPUs that are in nohz_full mode.
> +			   These CPUs are set by boot parameter "nohz_full=".
> +
> +		isolated: (RO) the list of CPUs that are isolated and don't
> +			  participate in load balancing. These CPUs are set by
> +			  boot parameter "isolcpus=".

These should be two different entries, not one please.

thanks,

greg k-h

^ permalink raw reply	[flat|nested] 3+ messages in thread

* RE: [PATCH] docs: document the sysfs ABI for "nohz_full" and "isolated"
  2021-12-01  7:34 ` Greg KH
@ 2021-12-01 11:21   ` tarumizu.kohei
  0 siblings, 0 replies; 3+ messages in thread
From: tarumizu.kohei @ 2021-12-01 11:21 UTC (permalink / raw)
  To: 'Greg KH'
  Cc: linux-kernel, riel, mchehab+huawei, will, catalin.marinas,
	corbet, ionela.voinescu, pcc, bilbao, matorola, rafael

Thanks for your comment.

> These should be two different entries, not one please.

We would like to send the next version patch with separate entries.

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2021-12-01 11:21 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-12-01  7:18 [PATCH] docs: document the sysfs ABI for "nohz_full" and "isolated" Kohei Tarumizu
2021-12-01  7:34 ` Greg KH
2021-12-01 11:21   ` tarumizu.kohei

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).