new test to demonstrate a race condition
[charm.git] / tests / charm++ / ckAllocSysMsgTest / README
1    This test is to demonstrate a race condition in the SMP build of
2    charm++.
3
4    Main launches a batch of Array and Group in a loop.
5    
6    The Array and group each engage in a ring and complete by reporting
7    to main.  Main will not start on the new batch until all elements
8    of the previous batch complete.
9    
10    This test is expected to hang in SMP mode if the bug is present.
11
12    By default a periodic timeout is registered which will trigger an abort
13    if the number of batches doesn't progress between periods. 
14
15    We do not construct the group or array inside main because the
16    CkAllocSysMsg race condition only affects group construction in
17    parallel execution.
18
19    The array must be multidimensional so that its indices will have
20    non zero values 
21
22    For sample usage, see make test.