teshsuite/smpi/mpich-test/README

   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.
   5
   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.
   9
  10 To build and run the tests, execute configure followed by make testing.
  11 The options to configure for some MPI implementations follow:
  12
  13 SGI:
  14       ./configure -cc=cc -fc=f77
  15 IBM:
  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)
  20 MPICH:
  21       ./configure -mpichpath=<path to MPICH build bin directory>
  22
  23 The directories are as follows:
  24
  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.
  30
  31
  32 coll    -       Test programs for various collective operations
  33
  34 context -       Test programs for context operations
  35
  36 env     -       Test programs for the environment routines
  37
  38 profile -       Test program(s) for MPI_Pcontrol
  39
  40 topol   -       Test programs for the topology routines
  41
  42 lederman-       A series of tests of various types written by Steve
  43                 Lederman
  44
  45
  46 Other directories and additional tests will be added in the future.
  47
  48 To run the test, but not leave the executables around, do (in this directory)
  49
  50   make TESTARGS=-small testing >& testing.out
  51
  52 If your MPI requires a boot step before running programs, use the target
  53 testing-boot instead of testint:
  54
  55   make TESTARGS=-small testing-boot >& testing.out
  56
  57 This will boot any MPI startup demons, and it will stop them at the end of the
  58 test.
  59
  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
  62        configure -help
  63 and a list of configure options will be provided.
  64
  65 You will probably also have to provide an "mpirun" program or script.
  66 This has roughly the form
  67
  68      mpirun -mvhome -np n -mvback "string" programname programargs
  69
  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.
  75