[PATCH 2/2] sched/rt: Document RT_RUNTIME_SHARE sched feature

[Daniel Bristot de Oliveira]

Add a comment explaining the RT_RUNTIME_SHARE sched feature.

Signed-off-by: Daniel Bristot de Oliveira <bristot@xxxxxxxxxx>
Cc: Ingo Molnar <mingo@xxxxxxxxxx>
Cc: Peter Zijlstra <peterz@xxxxxxxxxxxxx>
Cc: Steven Rostedt <rostedt@xxxxxxxxxxx>
Cc: Clark Williams <williams@xxxxxxxxxx>
Cc: Luis Claudio R. Goncalves <lgoncalv@xxxxxxxxxx>
Cc: linux-kernel@xxxxxxxxxxxxxxx

diff --git a/kernel/sched/features.h b/kernel/sched/features.h
index 5fffebfe..531c4bb 100644
--- a/kernel/sched/features.h
+++ b/kernel/sched/features.h
@@ -65,7 +65,17 @@ SCHED_FEAT(RT_PUSH_IPI, true)
 #endif
 
 SCHED_FEAT(FORCE_SD_OVERLAP, false)
+
+/*
+ * Enables the sharing of rt_runtime between CPUs, allowing a CPU to
+ * run a real-time task up to 100% of the time while leaving more
+ * space for non-real-time tasks to run on the CPU that lend rt_runtime.
+ *
+ * WARNING: This may allow the starvation of non-real-time tasks pinned
+ * to the CPU in which a spinning rt-task runs forever.
+ */
 SCHED_FEAT(RT_RUNTIME_SHARE, false)
+
 SCHED_FEAT(LB_MIN, false)
 SCHED_FEAT(ATTACH_AGE_LOAD, true)
 
-- 
2.7.4