Changeset 443 for trunk/kernel/kern/cluster.h

Timestamp:

May 16, 2018, 4:15:22 PM (5 years ago)

Author:

alain

Message:

Fix few bugs whike debugging the sort multi-thread application.

File:

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

trunk/kernel/kern/cluster.h

@@ -61 +61 @@
  * Warning : the "owner" cluster, and the "reference" cluster can be different clusters.
  *
- * The process manager of a cluster K maintains three structures:
- * 1) The pref_tbl[] is an array indexed by lpid. There is one entry per owned process.
+ * The process manager of a cluster K maintains three sets of process descriptors:
+ *
+ * 1) pref_tbl[] is an array indexed by lpid. There is one entry per owned process.
  *    Each entry contains an extended pointer on the reference process descriptor.
  *
- * 2) The local_root is the root of the local list of process descriptors in cluster K.
+ * 2) The local_root is the root of the local list of all process descriptors in cluster K.
  *    A process descriptor P is present in K, as soon as P has a thread in cluster K.
  *
@@ -187 +188 @@
 /******************************************************************************************
  * This function returns an extended pointer on the process descriptor in owner cluster
- * from the process PID. This PID can be be different from the calling process PID.
+ * from the process <pid>. This PID can be be different from the calling process PID.
  * It can be called by any thread running in any cluster,
  ******************************************************************************************
@@ -197 +198 @@
 /******************************************************************************************
  * This function returns an extended pointer on the reference process descriptor
- * from the process PID. This PID can be be different from the calling process PID.
+ * from the process <pid>. This PID can be be different from the calling process PID.
  * It can be called by any thread running in any cluster,
  ******************************************************************************************
@@ -204 +205 @@
  *****************************************************************************************/
 xptr_t cluster_get_reference_process_from_pid( pid_t pid );
+
+/******************************************************************************************
+ * This function returns an extended pointer on the process descriptor copy for the
+ * process identified by <pid> in cluster defined by <cxy> argument.
+ * This PID can be be different from the calling process PID.
+ * It can be called by any thread running in any cluster,
+ ******************************************************************************************
+ * @ cxy  : target cluster identifier.
+ * @ pid  : process identifier.
+ * @ return extended pointer on reference process if found / XPTR_NULL if not found.
+ *****************************************************************************************/
+xptr_t cluster_get_process_from_pid_in_cxy( cxy_t cxy,
+                                            pid_t pid );
 
 /******************************************************************************************