Changeset 409 for trunk/kernel/syscalls/syscalls.h

Timestamp:

Dec 20, 2017, 4:51:09 PM (6 years ago)

Author:

alain

Message:

Fix bugs in exec

File:

• trunk/kernel/syscalls/syscalls.h (modified) (4 diffs)

trunk/kernel/syscalls/syscalls.h

@@ -40 +40 @@
  * and makes the exit_value pointer available to any successful pthread_join() with the 
  * terminating thread.
- ******************************************************************************************
- * @ exit_vallue  : pointer to be returned to parent thread if thread is attached.
- * @ return 0 if success / return -1 if failure.
+ * It actually set the THREAD_SIG_EXIT signal, set the THREAD_BLOCKED_GLOBAL bit in the
+ * thread descriptor and deschedule.
+ * The thread will be detached from its process, and the memory allocated to the thread
+ * descriptor will be released later by the scheduler.
+ ******************************************************************************************
+ * @ exit_vallue  : pointer to be returned to joining thread if thread is attached.
+ * @ return 0 if success / return -1 if all locks not released or illegal argument.
  *****************************************************************************************/
 int sys_thread_exit( void * exit_value );
@@ -87 +91 @@
  * [4] This function detach a joinable thread.
  ******************************************************************************************
- * @ trdid   : thread identifier.i
+ * @ trdid   : thread identifier.
  * @ return 0 if success / return -1 if failure.
  *****************************************************************************************/
@@ -93 +97 @@
 
 /****************************************************************************************** 
- * [5] This slot is not used.
- *****************************************************************************************/
+ * [5] This function requests a target thread identified by its <trdid> argument
+ * to be cancelled. Depending on killer thread and target thread location, it calls
+ * the thread_kil() function or the rpc_thread_kill_client() function to do the work.
+ * It actually set the THREAD_SIG_KILL signal, set the THREAD_BLOCKED_GLOBAL bit in the
+ * target thread descriptor and return.
+ * The thread will be detached from its process, and the memory allocated to the thread
+ * descriptor will be released later by the scheduler.
+ ******************************************************************************************
+ * @ trdid   : thread identifier.
+ * @ return 0 if success / return -1 if illegal argument.
+ *****************************************************************************************/
+int sys_thread_cancel( trdid_t  trdid );
 
 /****************************************************************************************** 
@@ -158 +172 @@
  * @ status   : terminaison status (not used in present implementation).
  *****************************************************************************************/
-void sys_exit( uint32_t status );
+int sys_exit( uint32_t status );
 
 /******************************************************************************************