Changeset 14 for trunk/kernel/kern/thread.h

Timestamp:

May 3, 2017, 1:23:24 PM (7 years ago)

Author:

alain

Message:

Bugs fix.

File:

• trunk/kernel/kern/thread.h (modified) (4 diffs)

trunk/kernel/kern/thread.h

@@ -158 +158 @@
         core_t            * core;            /*! pointer to the owner core                */
         process_t         * process;         /*! pointer on local process descriptor      */
-        page_t            * page;            /*! pointer on page desc. containing thread  */ 
 
         uint32_t            local_locks;         /*! number of local locks owned by thread    */
@@ -266 +265 @@
 /***************************************************************************************
  * This function allocates memory for a kernel thread descriptor in the local cluster,
- * and initialise it from arguments values.
+ * and initialise it from arguments values, calling the thread_kernel_init() function,
+ * that also allocates and initializes the CPU context.
  * The THREAD_BLOCKED_GLOBAL bit is set, and the thread must be activated to start.   
  ***************************************************************************************
@@ -283 +283 @@
 
 /***************************************************************************************
+ * This function initialises an existing kernel thread descriptor from arguments values.
+ * The THREAD_BLOCKED_GLOBAL bit is set, and the thread must be activated to start.   
+ ***************************************************************************************
+ * @ thread   : pointer on existing thread descriptor.
+ * @ type     : kernel thread type.
+ * @ func     : pointer on function.
+ * @ args     : function arguments.
+ * @ core_lid : local core index.
+ * @ returns 0 if success / returns EINVAL if error
+ **************************************************************************************/
+error_t thread_kernel_init( thread_t      * thread,
+                            thread_type_t   type,
+                            void          * func, 
+                            void          * args,
+                            lid_t           core_lid );
+
+/***************************************************************************************
  * This function releases the physical memory allocated for a thread descriptor 
  * in the local cluster. It can be used for both an user and a kernel thread.
@@ -293 +310 @@
 
 /***************************************************************************************
- * This function defines the code of the thread executed when no other thread is 
- * runnable for a given core. It try to force the core to the low-power state.
- **************************************************************************************/
-void * thread_idle_func();
+ * This function defines the code of the thread executed by all cores after kernel_init,
+ * or when no other thread is runnable for a given core.
+ *
+ * TODO: In the TSAR architecture, it enters an infinite loop, in wich it forces 
+ * the core in sleep (low-power) mode. Any IRQ will force the core to exit this sleep
+ * mode, but no ISR is executed.
+ * TODO: We must analyse if we have the same behaviour for I86 architectures...
+ **************************************************************************************/
+void thread_idle_func();
 
 /***************************************************************************************