1 This directory contains a variety of different test codes
2 of different types. This directory and many of the files in
3 it are still undergoing active development and change. Please
4 forgive (and report) any problems you have with these programs.
6 These tests may be used with any MPI implementation. In a few cases,
7 differences in error messages may be reported; these are not errors, of
8 course. However, the accuracy and detail of the messages should be evaluated.
10 To build and run the tests, execute configure followed by make testing.
11 The options to configure for some MPI implementations follow:
14 ./configure -cc=cc -fc=f77
16 ./configure -cc=mpcc -fc=mpxlf
17 (You also need a script called "mpirun" that takes a -np number-of-procs
18 argument, since there are so many different ways to run parallel
19 programs on IBM systems)
21 ./configure -mpichpath=<path to MPICH build bin directory>
23 The directories are as follows:
25 pt2pt - Test cases that generally cover various point to point
26 routines, such as send, isend, probe, etc... The
27 README in this directory contains some additional
28 useful information about running the tests. The tests
29 in this directory are most complete.
32 coll - Test programs for various collective operations
34 context - Test programs for context operations
36 env - Test programs for the environment routines
38 profile - Test program(s) for MPI_Pcontrol
40 topol - Test programs for the topology routines
42 lederman- A series of tests of various types written by Steve
46 Other directories and additional tests will be added in the future.
48 To run the test, but not leave the executables around, do (in this directory)
50 make TESTARGS=-small testing >& testing.out
52 If your MPI requires a boot step before running programs, use the target
53 testing-boot instead of testint:
55 make TESTARGS=-small testing-boot >& testing.out
57 This will boot any MPI startup demons, and it will stop them at the end of the
60 If you are NOT using the MPICH implementation, then you can run the configure
61 script in this directory. If you need to view the configure options, then type
63 and a list of configure options will be provided.
65 You will probably also have to provide an "mpirun" program or script.
66 This has roughly the form
68 mpirun -mvhome -np n -mvback "string" programname programargs
70 The options -mvhome and -mvback "string" can be ignored; they are needed only
71 on systems that do not share file systems with the system running the runtests
72 script (yes, there is one such system). The option "-np n" specifies that
73 "n" processes are needed. Note that this is not always a power of 2; systems
74 must be prepared to accept any (small) value of n.