Changeset 623 for trunk/kernel/libk/remote_barrier.h

Timestamp:

Mar 6, 2019, 4:37:15 PM (5 years ago)

Author:

alain

Message:

Introduce three new types of vsegs (KCODE,KDATA,KDEV)
to map the kernel vsegs in the process VSL and GPT.
This now used by both the TSAR and the I86 architectures.

File:

• trunk/kernel/libk/remote_barrier.h (modified) (5 diffs)

trunk/kernel/libk/remote_barrier.h

@@ -42 +42 @@
  * used by the kernel. ALMOS-MKH uses only the barrier virtual address as an identifier.
  * For each user barrier, ALMOS-MKH creates a kernel structure, dynamically allocated 
- * by the "generic_barrier_create()" function, destroyed by the "remote_barrier_destroy()"
- * function, and used by the "generic_barrier_wait()" function.
+ * by the generic_barrier_create() function, destroyed by the generic_barrier_destroy()
+ * function, and used by the generic_barrier_wait() function.
  *
  * Implementation note:
@@ -58 +58 @@
  *    (x_size * ysize) mesh, including cluster (0,0), with nthreads per cluster, and called
  *    DQT : Distributed Quad Tree. This DQT implementation supposes a regular architecture, 
+                     uint32_t arity = hal_remote_l32( XPTR( node_cxy , &node_ptr->arity       ));
  *    and a strong contraint on the threads placement: exactly "nthreads" threads per 
  *    cluster in the (x_size * y_size) mesh.
@@ -141 +142 @@
 
 
-
+/*****************************************************************************************
+ * This debug function uses remote accesses to display the current state of a generic
+ * barrier identified by the <gen_barrier_xp> argument. 
+ * It calls the relevant function (simple or DQT) to display relevant information.
+ * It can be called by a thread running in any cluster.
+ *****************************************************************************************
+ * @ barrier_xp   : extended pointer on generic barrier descriptor.
+ ****************************************************************************************/
+
+void generic_barrier_display( xptr_t gen_barrier_xp );
 
 
@@ -192 +202 @@
 void simple_barrier_wait( xptr_t   barrier_xp );
 
+/*****************************************************************************************
+ * This debug function uses remote accesses to display the current state of a simple
+ * barrier identified by the <barrier_xp> argument.
+ * It can be called by a thread running in any cluster.
+ *****************************************************************************************
+ * @ barrier_xp   : extended pointer on simple barrier descriptor.
+ ****************************************************************************************/
+void simple_barrier_display( xptr_t barrier_xp );
 
 
@@ -281 +299 @@
 void dqt_barrier_wait( xptr_t   barrier_xp );
 
-
+/*****************************************************************************************
+ * This debug function uses remote accesses to display the current state of all 
+ * ditributed nodes in a DQT barrier identified by the <barrier_xp> argument.
+ * It can be called by a thread running in any cluster.
+ *****************************************************************************************
+ * @ barrier_xp   : extended pointer on DQT barrier descriptor.
+ ****************************************************************************************/
+void dqt_barrier_display( xptr_t barrier_xp );
 
 #endif  /* _REMOTE_BARRIER_H_ */