WebSVN – HelenOS-historic – Diff – /kernel/trunk/generic/src/proc/scheduler.c

  */
 spinlock_t nrdylock;
 volatile int nrdy;
+/** Initialize context switching
+ *
+ * Initialize context switching and lazy FPU
+ * context switching.
+ *
+ */
 void before_thread_runs(void)
+{
     before_thread_runs_arch();
     fpu_context_restore(&(THREAD->saved_fpu_context));
+}
+/** Initialize scheduler
+ *
+ * Initialize kernel scheduler.
+ *
+ */
 void scheduler_init(void)
+{
     spinlock_initialize(&nrdylock);
+}
-/* cpu_priority_high()'d */
+/** Get thread to be scheduled
+ *
+ * Get the optimal thread to be scheduled
+ * according thread accounting and scheduler
+ * policy.
+ *
+ * @return Thread to be scheduled.
+ *
+ */
 struct thread *find_best_thread(void)
+{
     thread_t *t;
     runq_t *r;
     int i, n;
+    }
     goto loop;
+}
+/** Prevent rq starvation
-/*
+ *
- * This function prevents low priority threads from starving in rq's.
+ * Prevent low priority threads from starving in rq's.
+ *
- * When it decides to relink rq's, it reconnects respective pointers
+ * When the function decides to relink rq's, it reconnects
- * so that in result threads with 'pri' greater or equal 'start' are
+ * respective pointers so that in result threads with 'pri'
- * moved to a higher-priority queue.
+ * greater or equal 'start' are moved to a higher-priority queue.
+ *
+ * @param start Threshold priority.
+ *
  */
 void relink_rq(int start)
+{
     link_t head;
     runq_t *r;
+    }
     spinlock_unlock(&CPU->lock);
+}
-/*
- * The scheduler.
+/** The scheduler
+ *
+ * The thread scheduling procedure.
+ *
  */
 void scheduler(void)
+{
     volatile pri_t pri;
     context_set(&CPU->saved_context, FADDR(scheduler_separated_stack), CPU->stack, CPU_STACK_SIZE);
     context_restore(&CPU->saved_context);
     /* not reached */
+}
+/** Scheduler stack switch wrapper
+ *
+ * Second part of the scheduler() function
+ * using new stack. Handling the actual context
+ * switch to a new thread.
+ *
+ */
 void scheduler_separated_stack(void)
+{
     int priority;
     if (THREAD) {
     context_restore(&THREAD->saved_context);
     /* not reached */
+}
 #ifdef __SMP__
+/** Load balancing thread
-/*
+ *
- * This is the load balancing thread.
+ * SMP load balancing thread, supervising thread supplies
- * It supervises thread supplies for the CPU it's wired to.
+ * for the CPU it's wired to.
+ *
+ * @param arg Generic thread argument (unused).
+ *
  */
 void kcpulb(void *arg)
+{
     thread_t *t;
     int count, i, j, k = 0;

Subversion Repositories HelenOS-historic

(root)/kernel/trunk/generic/src/proc/scheduler.c @ 1757 – Rev 99 → 107