

/*D

    MPI - Introduction to the Message-Passing Interface

Description:

MPI stands for Message Passing Interface.
MPI is a specification (like C or Fortran) and there are a number of 
implementations.  The rest of this man page describes the use of the MPICH
implementation of MPI.

Getting started:

Add MPI to your path
.vb
	% set path = ( $path /usr/local/mpi/bin )
.ve
for the 'csh' and 'tcsh' shells, or
.vb
        % export path=$path:/usr/local/mpi/bin
.ve
for 'sh', 'ksh', and 'bash' shells.

Compute pi to a given resolution on 8 processes
.vb
	% mpiexec -n 8 /usr/local/mpi/examples/cpi
.ve

You can compile and link your own MPI programs with the commands 'mpicc',
'mpif77', 'mpicxx', and 'mpif90'\:
.vb
        % mpicc -o cpi cpi.c
        % mpif77 -o fpi fpi.f
	% mpicxx -o cxxpi cxxpi.cxx
        % mpif790 -o pi3f90 pi3f90.f90
.ve
using the source code from `/usr/local/mpi/examples`.

Documentation:

PDF documentation can be found in directory
'/usr/local/mpi/doc/'.  These include an installation manual ('install.pdf') 
and a user''s manual ('usermanual.pdf').

Man pages exist for every MPI subroutine and function.  The man pages are
also available on the Web at 'http://www.mcs.anl.gov/mpi/www'.
Additional on-line information is available at 'http://www.mcs.anl.gov/mpi',
including a hypertext version of the standard, information on other libraries
that use MPI, and pointers to other MPI resources.

Version:

MPICH2 version 1.0

License:

Copyright 2002 University of Chicago.
See the file 'COPYRIGHT' for details.  The source code is freely available
by anonymous ftp from 'ftp.mcs.anl.gov' in 'pub/mpi/mpich2-beta.tar.gz' .

Files:

.vb
/usr/local/mpi/                 MPI software directory
/usr/local/mpi/COPYRIGHT        Copyright notice
/usr/local/mpi/README           various notes and instructions
/usr/local/mpi/bin/             binaries, including mpiexec and mpicc
/usr/local/mpi/examples         elementary MPI programs
/usr/local/mpi/doc/             documentation
/usr/local/mpi/include/         include files
/usr/local/mpi/lib/             library files
.ve

Contact:

MPI-specific suggestions and bug reports should
be sent to 'mpich-discuss@mcs.anl.gov'.

D*/
