Blame test/mpi/manual/README

Packit 0848f5
This directory contains programs and tests that need to be run by
Packit 0848f5
a human being rather than a script.  Instructions on running each test
Packit 0848f5
are in the test file at the top.
Packit 0848f5
Packit 0848f5
singjoin - A test of Comm_join, including a test of comm_join by singleton
Packit 0848f5
           processes
Packit 0848f5
Packit 0848f5
testconnect - A test of Comm_connect and Comm_accept, with many processes.
Packit 0848f5
              Use the script manyconnect to run them, as in
Packit 0848f5
Packit 0848f5
make testconnect
Packit 0848f5
./manyconnect
Packit 0848f5
Packit 0848f5
dimsbalanced - A test of MPI_Dims_create; this checks that Dims_create 
Packit 0848f5
               produces well-balanced results.  Since there are no 
Packit 0848f5
               requirements on the "balance" of the output of Dims_create,
Packit 0848f5
               this is a test of the quality of implementation of the
Packit 0848f5
               default MPI_Dims_create when there is no underlying 
Packit 0848f5
               network topology.
Packit 0848f5
Packit 0848f5
spawntest_master, spawntest_child - A test of MPI_Comm_disconnect to ensure
Packit 0848f5
		  that once processes are disconnected, one can proceed
Packit 0848f5
		  through MPI_Finalize without waiting for the other to
Packit 0848f5
		  also proceed through MPI_Finalize.  This test is 
Packit 0848f5
		  designed to succeed even if either the child or master
Packit 0848f5
		  waits for the other in MPI_Finalize.  If MPI_Comm_disconnect
Packit 0848f5
		  works correctly, the spawned children (4 by default), 
Packit 0848f5
		  should exit roughly 30 seconds before the master.
Packit 0848f5
Packit 0848f5
segfault - a simple test that intentionally segfaults if its rank is 0,
Packit 0848f5
           otherwise does nothing.  The output from mpiexec should make it clear
Packit 0848f5
           that one of the processes segfaulted (not just terminated badly), and
Packit 0848f5
           ideally indicate which process.  Make sure to run it with a range of
Packit 0848f5
           comm_world sizes, including 1 and 2.