linux-kernel - [PATCH] docs/scheduler: Fix busy and idle type ordering

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-Id: <20241209035428.898293-1-adamli@os.amperecomputing.com>
Date: Mon,  9 Dec 2024 03:54:28 +0000
From: Adam Li <adamli@...amperecomputing.com>
To: corbet@....net,
	mingo@...nel.org,
	sshegde@...ux.ibm.com
Cc: linux-doc@...r.kernel.org,
	linux-kernel@...r.kernel.org,
	patches@...erecomputing.com,
	Adam Li <adamli@...amperecomputing.com>
Subject: [PATCH] docs/scheduler: Fix busy and idle type ordering

Commit 11b0bfa5d463 ("sched/debug: Increase SCHEDSTAT_VERSION to 16")
documented change of CPU_IDLE and __CPU_NOT_IDLE ordering in
'enum cpu_idle_type'.

Fix the domain statistics description due to the ordering change.

Signed-off-by: Adam Li <adamli@...amperecomputing.com>
---
 Documentation/scheduler/sched-stats.rst | 34 ++++++++++++-------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/Documentation/scheduler/sched-stats.rst b/Documentation/scheduler/sched-stats.rst
index 7c2b16c4729d..ab6f5392910d 100644
--- a/Documentation/scheduler/sched-stats.rst
+++ b/Documentation/scheduler/sched-stats.rst
@@ -78,39 +78,39 @@ domain<N> <cpumask> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
 The first field is a bit mask indicating what cpus this domain operates over.
 
 The next 24 are a variety of sched_balance_rq() statistics in grouped into types
-of idleness (idle, busy, and newly idle):
+of idleness (busy, idle, and newly idle):
 
     1)  # of times in this domain sched_balance_rq() was called when the
-        cpu was idle
+        cpu was busy
     2)  # of times in this domain sched_balance_rq() checked but found
-        the load did not require balancing when the cpu was idle
+        the load did not require balancing when the cpu was busy
     3)  # of times in this domain sched_balance_rq() tried to move one or
-        more tasks and failed, when the cpu was idle
+        more tasks and failed, when the cpu was busy
     4)  sum of imbalances discovered (if any) with each call to
-        sched_balance_rq() in this domain when the cpu was idle
+        sched_balance_rq() in this domain when the cpu was busy
     5)  # of times in this domain pull_task() was called when the cpu
-        was idle
+        was busy
     6)  # of times in this domain pull_task() was called even though
-        the target task was cache-hot when idle
+        the target task was cache-hot when busy
     7)  # of times in this domain sched_balance_rq() was called but did
-        not find a busier queue while the cpu was idle
+        not find a busier queue while the cpu was busy
     8)  # of times in this domain a busier queue was found while the
-        cpu was idle but no busier group was found
+        cpu was busy but no busier group was found
     9)  # of times in this domain sched_balance_rq() was called when the
-        cpu was busy
+        cpu was idle
     10) # of times in this domain sched_balance_rq() checked but found the
-        load did not require balancing when busy
+        load did not require balancing when idle
     11) # of times in this domain sched_balance_rq() tried to move one or
-        more tasks and failed, when the cpu was busy
+        more tasks and failed, when the cpu was idle
     12) sum of imbalances discovered (if any) with each call to
-        sched_balance_rq() in this domain when the cpu was busy
-    13) # of times in this domain pull_task() was called when busy
+        sched_balance_rq() in this domain when the cpu was idle
+    13) # of times in this domain pull_task() was called when idle
     14) # of times in this domain pull_task() was called even though the
-        target task was cache-hot when busy
+        target task was cache-hot when idle
     15) # of times in this domain sched_balance_rq() was called but did not
-        find a busier queue while the cpu was busy
+        find a busier queue while the cpu was idle
     16) # of times in this domain a busier queue was found while the cpu
-        was busy but no busier group was found
+        was idle but no busier group was found
 
     17) # of times in this domain sched_balance_rq() was called when the
         cpu was just becoming idle
-- 
2.25.1