X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Fkern%2Fproc_p.h;h=54ba7be187014ac3527c169b8aea1ce735e1dce8;hb=6eb6ebb5ae5953a27977f0ef66a36344462b949a;hp=7dad780d4fb03098ce3f388afcee3750acec50bb;hpb=dc9c2e09cf5e9837cdd3106c57db749301c5bf95;p=bertos.git diff --git a/bertos/kern/proc_p.h b/bertos/kern/proc_p.h index 7dad780d..54ba7be1 100644 --- a/bertos/kern/proc_p.h +++ b/bertos/kern/proc_p.h @@ -34,7 +34,6 @@ * \brief Internal scheduler structures and definitions for processes. * * \version $Id$ - * * \author Bernie Innocenti */ @@ -46,7 +45,7 @@ #include /* for cpu_stack_t */ -#include +#include typedef struct Process { @@ -94,11 +93,24 @@ typedef struct Process /** Track running processes. */ extern REGISTER Process *CurrentProcess; -/** Track ready processes. */ +/** + * Track ready processes. + * + * Access to this list must be protected with a proc_forbid() / proc_premit() + * pair, or with SCHED_ATOMIC() + */ extern REGISTER List ProcReadyList; -/** Enqueue a task in the ready list. */ +/** + * Enqueue a task in the ready list. + * + * Always use this macro to instert a process in the ready list, as its + * might vary to implement a different scheduling algorithms. + * + * \note This macro is *NOT* protected against the scheduler. Access to + * this list must be performed with interrupts disabled. + */ #define SCHED_ENQUEUE(proc) ADDTAIL(&ProcReadyList, &(proc)->link) /** Schedule to another process *without* adding the current to the ready list. */ @@ -119,4 +131,3 @@ void proc_schedule(void); #endif /* CONFIG_KERN_MONITOR */ #endif /* KERN_PROC_P_H */ -