svn commit: r287166 - head/sys/kern

[George V. Neville-Neil]

Author: gnn
Date: Wed Aug 26 16:36:41 2015
New Revision: 287166
URL: https://svnweb.freebsd.org/changeset/base/287166

Log:
  Summary: Add the interactivity equations to the header comment for our
  interactivity calculation routine.
  
  Suggested by: rwatson

Modified:
  head/sys/kern/sched_ule.c

Modified: head/sys/kern/sched_ule.c
==============================================================================
--- head/sys/kern/sched_ule.c	Wed Aug 26 13:23:56 2015	(r287165)
+++ head/sys/kern/sched_ule.c	Wed Aug 26 16:36:41 2015	(r287166)
@@ -1450,6 +1450,21 @@ sched_initticks(void *dummy)
  * a [0, 100] integer.  This is the voluntary sleep time of a process, which
  * differs from the cpu usage because it does not account for time spent
  * waiting on a run-queue.  Would be prettier if we had floating point.
+ *
+ * When a thread's sleep time is greater than its run time the
+ * calculation is:
+ *
+ *                           scaling factor 
+ * interactivity score =  ---------------------
+ *                        sleep time / run time
+ *
+ *
+ * When a thread's run time is greater than its sleep time the
+ * calculation is:
+ *
+ *                           scaling factor 
+ * interactivity score =  ---------------------    + scaling factor
+ *                        run time / sleep time
  */
 static int
 sched_interact_score(struct thread *td)