Changeset 436 for trunk/kernel/kern/rpc.h

Timestamp:

Mar 7, 2018, 9:02:03 AM (6 years ago)

Author:

alain

Message:

1) improve the threads and process destruction mechanism.
2) introduce FIFOs in the soclib_tty driver.

File:

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

trunk/kernel/kern/rpc.h

@@ -48 +48 @@
 struct mapper_s;
 
+
 /**********************************************************************************/
 /**************  structures for Remote Procedure Calls ****************************/
@@ -67 +68 @@
     RPC_THREAD_USER_CREATE     = 6,
     RPC_THREAD_KERNEL_CREATE   = 7,
-    RPC_THREAD_KILL            = 8,
+    RPC_UNDEFINED_8            = 8,
     RPC_PROCESS_SIGACTION      = 9,
 
@@ -288 +289 @@
 
 /***********************************************************************************
- * [8] The RPC_THREAD_KILL ask a target cluster to kill a given thread descriptor.
- * It is called by the sys_thread_cancel() function for a remote thread.
- ***********************************************************************************
- * @ cxy       : server cluster identifier.
- * @ thread   : [in]  local pointer on target process descriptor in server.
- **********************************************************************************/
-void rpc_thread_kill_client( cxy_t              cxy,
-                             struct thread_s  * thread );
-                             
-void rpc_thread_kill_server( xptr_t xp );
-
-/***********************************************************************************
- * [9] The RPC_PROCESS_SIGACTION allows the owner cluster to request any other
- * cluster to execute a given sigaction (BLOCK / UNBLOCK / DELETE) for all 
- * threads of a given process. 
+ * [8] undefined slot
+ **********************************************************************************/
+
+/***********************************************************************************
+ * [9] The RPC_PROCESS_SIGACTION allows a thread running in any cluster 
+ * to request a cluster identified by the <cxy> argument (local or remote)
+ * to execute a given sigaction for a given cluster. The <action_type> and 
+ * the <pid> arguments are defined in the shared RPC descriptor, that must be 
+ * initialised by the client thread.
  *
  * WARNING : It is implemented as a NON BLOCKING multicast RPC, that can be sent 
- * in parallel to all process copies. The rpc descriptor is allocated in the client
- * thread stack by the process_sigaction() function. The various server threads 
- * must decrement the responses counter defined in the rsp descriptor, and the last
- * server thread unblock the client thread that blocked (after sending all RPC
- * requests) in the process_sigaction() function.
- * - The first RPC argument is the sigaction type (BLOCK / UNBLOCK / DELETE).
- * - The second RPC argument is the local pointer on target process.
- ***********************************************************************************
- * @ cxy       : server cluster identifier.
- * @ rpc_ptr   : [in]  local pointer on rpc descriptor in client cluster.
- **********************************************************************************/
-void rpc_process_sigaction_client( cxy_t        cxy,
-                                   rpc_desc_t * rpc_ptr );
+ * in parallel to all process copies. The various RPC server threads atomically
+ * decrement the <response> field in the shared RPC descriptor.
+ * The last server thread unblock the client thread that blocked (after sending 
+ * all RPC requests) in the process_sigaction() function.
+ ***********************************************************************************
+ * @ cxy     : server cluster identifier.
+ * @ rpc     : pointer on ishared RPC descriptor initialized by the client thread.
+ **********************************************************************************/
+void rpc_process_sigaction_client( cxy_t               cxy,
+                                   struct rpc_desc_s * rpc );
                              
 void rpc_process_sigaction_server( xptr_t xp );