sched/Documentation/sched-rt-group: Fix incorrect example
authorZhou Chengming <zhouchengming1@huawei.com>
Sun, 22 Jan 2017 07:22:35 +0000 (15:22 +0800)
committerIngo Molnar <mingo@kernel.org>
Sun, 22 Jan 2017 09:34:17 +0000 (10:34 +0100)
I feel that the example given in the document to show the possibility
of task starvation of configurable period is wrong.

The example says group A and B both have 50% bandwidth, and a while (1)
loop in A will run for the full period of B and can starve B's tasks.

So I think the runtime of group A should be 50000us, then the period and
runtime of group B should be 50000us and 25000us.

Signed-off-by: Zhou Chengming <zhouchengming1@huawei.com>
Cc: Linus Torvalds <torvalds@linux-foundation.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: corbet@lwn.net
Cc: iamyooon@gmail.com
Cc: linux-doc@vger.kernel.org
Cc: lizefan@huawei.com
Link: http://lkml.kernel.org/r/1485069755-44287-1-git-send-email-zhouchengming1@huawei.com
Signed-off-by: Ingo Molnar <mingo@kernel.org>
Documentation/scheduler/sched-rt-group.txt

index a03f0d944fe6dad87415588c3554bff04697a745..d8fce3e784574ee4d1653fd419a01220f15608bb 100644 (file)
@@ -158,11 +158,11 @@ as its prone to starvation without deadline scheduling.
 Consider two sibling groups A and B; both have 50% bandwidth, but A's
 period is twice the length of B's.
 
-* group A: period=100000us, runtime=10000us
-       - this runs for 0.01s once every 0.1s
+* group A: period=100000us, runtime=50000us
+       - this runs for 0.05s once every 0.1s
 
-* group B: period= 50000us, runtime=10000us
-       - this runs for 0.01s twice every 0.1s (or once every 0.05 sec).
+* group B: period= 50000us, runtime=25000us
+       - this runs for 0.025s twice every 0.1s (or once every 0.05 sec).
 
 This means that currently a while (1) loop in A will run for the full period of
 B and can starve B's tasks (assuming they are of lower priority) for a whole