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

Timestamp:

Nov 10, 2018, 2:16:38 PM (5 years ago)

Author:

alain

Message:

Cosmetic: improve debug.

File:

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

trunk/kernel/kern/process.h

@@ -289 +289 @@
  * all threads of a process identified by the <pid> argument, depending on the 
  * <action_type> argument.
- * WARNING : the DELETE and BLOCK actions are NOT executed on the target process main thread
- * (thread 0 in process owner cluster), and not executed on the calling thread itself.
+ *
  * It uses the multicast, non blocking rpc_process_sigaction_client() function to send
  * parallel requests to all remote clusters containing process copies. 
@@ -298 +297 @@
  * It is also used by the process_make_exec() function to handle the "exec" syscall.
  * It is also called by the TXT device ISR to execute the ctrl C & ctrl Z commands.
+ *
+ * WARNING (1) the DELETE action is NOT executed on the target process main thread
+ * (thread 0 in process owner cluster), and not executed on the client thread itself.
+ *
+ * WARNING (2) the BLOCK action is executed on all target process threads, and this function
+ * returns only when all threads BUT the client thread are actually blocked and not running.
+ * When the client thread is also a target thread, it is blocked but not descheduled. 
+ * 
+ * WARNING (3) the UNBLOCK action is executed on all target process threads, as the
+ * client thread cannot be a target thread.
  *
  * Implementation note:
@@ -328 +337 @@
  * 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.
+ * and returns only when all threads in cluster, but the calling thread, are actually blocked.
  * The threads are not detached from the scheduler, and not detached from the local process.
  *********************************************************************************************