Changeset 583 for trunk/kernel/kern/process.h

Timestamp:

Nov 1, 2018, 12:10:42 PM (5 years ago)

Author:

alain

Message:

Improve signals.

File:

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

trunk/kernel/kern/process.h

@@ -312 +312 @@
 
 /*********************************************************************************************
- * This function blocks all threads for a given <process> in the local cluster. 
- * It scan the list of local thread, and sets the THREAD_BLOCKED_GLOBAL bit for all
- * threads, BUT the main thread (thread 0 in owner cluster), and the client thread
- * identified by the <client_xp> argument. It request the relevant schedulers to acknowledge
- * the blocking, using IPI if required, and returns only when all blockable threads 
- * in cluster are actually blocked.
- * The threads are not detached from the scheduler, and not detached from the local process.
- *********************************************************************************************
- * @ process     : pointer on the target process descriptor.
- * @ client_xp   : extended pointer on the client thread that should not be blocked.
- ********************************************************************************************/
-void process_block_threads( process_t * process,
-                            xptr_t      client_xp );
-
-/*********************************************************************************************
- * This function marks for deletion all threads for a given <process> in the local cluster.
+ * This function marks for delete all threads for a given <process> in the local cluster.
  * It scan the list of local thread, and sets the THREAD_FLAG_REQ_DELETE bit for all
  * threads, BUT the main thread (thread 0 in owner cluster), and the client thread
  * identified by the <client_xp> argument. 
- * The actual deletion will be done by the scheduler at the next scheduling point.
+ * The actual delete will be done by the scheduler at the next scheduling point.
  *********************************************************************************************
  * @ process     : pointer on the process descriptor.
@@ -337 +322 @@
  ********************************************************************************************/
 void process_delete_threads( process_t * process,
-                            xptr_t       client_xp );
+                             xptr_t      client_xp );
+
+/*********************************************************************************************
+ * This function blocks all threads for a given <process> in the local cluster. 
+ * It scan the list of local thread, and sets the THREAD_BLOCKED_GLOBAL bit for all threads.
+ * It request the relevant schedulers to acknowledge the blocking, using IPI if required, 
+ * and returns only when all threads in cluster are actually blocked.
+ * The threads are not detached from the scheduler, and not detached from the local process.
+ *********************************************************************************************
+ * @ process     : pointer on the target process descriptor.
+ ********************************************************************************************/
+void process_block_threads( process_t * process );
 
 /*********************************************************************************************
@@ -498 +494 @@
  * @ process  : pointer on the local process descriptor.
  * @ thread   : pointer on new thread to be registered.
- * @ trdid    : [out] address of buffer for allocated trdid.
+ * @ trdid    : [out] buffer for allocated trdid.
  * @ returns 0 if success / returns non zero if no slot available.
  ********************************************************************************************/
@@ -504 +500 @@
                                  struct thread_s * thread,
                                  trdid_t         * trdid );
-
-/*********************************************************************************************
- * This function atomically removes a thread registration from the local process descriptor
- * th_tbl[] array, using the relevant lock, depending on the kernel/user type.
- *********************************************************************************************
- * @ thread   : local pointer on thread to be removed.
- * @ return true if the removed thread was the last registered thread.
- ********************************************************************************************/
-bool_t process_remove_thread( struct thread_s * thread );