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

Timestamp:

Aug 2, 2018, 11:47:13 AM (6 years ago)

Author:

alain

Message:

This version modifies the exec syscall and fixes a large number of small bugs.
The version number has been updated (0.1)

File:

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

trunk/kernel/kern/thread.h

@@ -26 +26 @@
 #define _THREAD_H_
 
-#include <hal_types.h>
+#include <hal_kernel_types.h>
 #include <shared_syscalls.h>
 #include <hal_special.h>
@@ -161 +161 @@
     void              * entry_func;      /*! pointer on entry function                */
     void              * entry_args;      /*! pointer on entry function arguments      */
+    uint32_t            main_argc;       /*! main thread number of arguments          */
+    char             ** main_argv;       /*! main thread array of strings arguments   */
 
     uint32_t            flags;           /*! bit vector of flags                      */
@@ -218 +220 @@
  * The CPU context is initialized from scratch. 
  * It is registered in the local process descriptor specified by the <pid> argument.
- * The THREAD_BLOCKED_GLOBAL bit is set => the thread must be activated to start.
+ * The THREAD_BLOCKED_GLOBAL bit is set => the thread must be activated by the caller
+ * to start at the next scheduling point.
  ***************************************************************************************
  * @ pid          : process identifier.
@@ -258 +261 @@
 
 /***************************************************************************************
+ * This function is called by the process_make_exec() function to re-initialise the
+ * thread descriptor of the calling thread (that will become the new process main
+ * thread), and immediately jump to user code without returning to kentry!!!
+ * It must be called by the main thread of the calling process.
+ * - A new user stack vseg is created and initialised.
+ * - The kernel stack (currently in use) is not modified.  
+ * - The function calls the hal_cpu_context_exec() to re-initialize the CPU context
+ *   an jump to user code.  
+ ***************************************************************************************
+ * @ entry_func : main thread entry point.
+ * @ argc       : number of main thread arguments.
+ * @ argv       : array of pointers on stringarguments.
+ * @ returns 0 if success / returns ENOMEM if error.
+ **************************************************************************************/
+error_t thread_user_exec( void     * entry_func,
+                          uint32_t   argc,
+                          char    ** argv);
+
+/***************************************************************************************
  * This function allocates memory for a kernel thread descriptor in the local cluster,
  * and initializes it from arguments values. 
@@ -281 +303 @@
  * descriptor from arguments values.
  * The THREAD_BLOCKED_GLOBAL bit is set, and the thread must be activated to start.
+ * It returns a kernel panic if failure.
  ***************************************************************************************
  * @ thread   : pointer on existing thread descriptor.
@@ -287 +310 @@
  * @ args     : function arguments.
  * @ core_lid : local core index.
- * @ returns 0 if success / returns EINVAL if error
- **************************************************************************************/
-error_t thread_idle_init( thread_t      * thread,
-                          thread_type_t   type,
-                          void          * func,
-                          void          * args,
-                          lid_t           core_lid );
+ **************************************************************************************/
+void thread_idle_init( thread_t      * thread,
+                       thread_type_t   type,
+                       void          * func,
+                       void          * args,
+                       lid_t           core_lid );
 
 /***************************************************************************************