# 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

            % set path = ( $path /usr/local/mpi/bin )

for the `csh` and `tcsh` shells, or

            % export path=$path:/usr/local/mpi/bin

for `sh`, `ksh`, and `bash` shells.

Compute pi to a given resolution on 8 processes

            % mpiexec -n 8 /usr/local/mpi/examples/cpi

You can compile and link your own MPI programs with the commands `mpicc`, `mpif77`, `mpicxx`, and `mpif90`:

            % mpicc -o cpi cpi.c
            % mpif77 -o fpi fpi.f
            % mpicxx -o cxxpi cxxpi.cxx
            % mpif790 -o pi3f90 pi3f90.f90

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

    /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

## Contact

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

Location:manpage.txt