Changes between Version 9 and Version 10 of library_barrier

Timestamp:

Feb 11, 2015, 6:46:01 PM (9 years ago)

Author:

alain

Comment:

--

library_barrier

@@ -13 +13 @@
 
 The available functions are:
- * '''barrier_init( giet_barrier_t * barrier, unsigned int ntasks )'''
- * '''barrier_wait( giet_barrier_t * barrier )''' 
+ * '''barrier_init'''( giet_barrier_t * barrier, unsigned int ntasks )
+ * '''barrier_wait'''( giet_barrier_t * barrier )
 
 The ''barrier'' argument is a pointer on a ''giet_barrier_t'' object. The ''ntasks'' argument is the number of expected tasks.
@@ -22 +22 @@
 == B) Distributed Barrier == 
 
-The ''giet_sbt_barrier_t'' can be used in multi-clusters architectures, and is implemented as a physically distributed Sliced-Binary-Tree (SBT).
-The SBT topology is completely defined by the number of involved clusters, with the following constraints:
- * The number of involved clusters must be a power of 2.
- * The involved clusters form a mesh[X][Y] where (X = Y) or (X = 2*Y).
+The ''giet_sbt_barrier_t'' can be used in multi-clusters architectures, and is implemented as a - physically distributed - Synchronisation-Quad-Tree (SQT). The SQT topology is completely defined by the (x_size / y_size) parameters, with the following constraints:
+ * The involved clusters form a mesh(x_size * y_size).
  * The lower left involved cluster is cluster(0,0).
- * All involved clusters must contain a heap[x][y] vseg declared in the mapping.
- * The number of involved tasks in a given cluster is the same for all clusters
+ * All involved clusters must contain a heap_x_y vseg declared in the mapping.
+ * The number of involved tasks in a given cluster is the same for all involved clusters.
 
 The available functions are:
- * '''sbt_barrier_init( giet_sbt_barrier_t * barrier, unsigned int nclusters, unsigned int ntasks )'''
- * '''sbt_barrier_wait( giet_sbt_barrier_t * barrier )''' 
+ * '''sqt_barrier_init'''( giet_sbt_barrier_t * barrier, unsigned int x_size,  unsigned int y_size,  unsigned int ntasks )
+ * '''sqt_barrier_wait'''( giet_sbt_barrier_t * barrier ) 
 
 The '''barrier''' argument is a pointer on a ''giet_barrier_t'' object. 
-The '''nclusters''' argument is the number of involved clusters.
+The '''x_size''' argument is the number of clusters in a row.
+The '''y_size''' argument is the number of clusters in a column.
 The '''ntasks''' argument is the number of expected tasks in a single cluster.
-
-The sbt_barrier_init() contains a system call, but the sbt_barrier_wait() does not.
 
 == C) Barrier Initialization ==