\/
This User's Guide corresponds to Version 1.2.1 of mpich. It was processed by LaTeX on Tue Sep 5 14:50:55 2000.
MPI (Message-Passing Interface) is a standard specification for
message-passing libraries. mpich is a portable implementation of
the full MPI specification for a wide variety of parallel
and distributed computing
environments.
This paper describes how to build and run MPI programs using the mpich
implementation of MPI.
Version 1.2.1 of mpich is primarily a bug fix and increased portability release, particularly for LINUX-based clusters.
New in 1.2.1:
Improved support for assorted Fortran and Fortran 90 compilers. In particular, a single version of MPICH can now be built to use several different Fortran compilers; see the installation manual (in doc/install.ps.gz) for details.
Using a C compiler for MPI programs that use MPICH that is different from the one that MPICH was built with is also easier now; see the installation manual.
Significant upgrades have been made to the MPD system of daemons that provide fast startup of MPICH jobs, management of stdio, and a crude parallel debugger based on gdb. See the README file in the mpich/mpid/mpd directory and the mpich User's Guide for information on how to use the MPD system with mpich.
The NT version of MPICH has been further enhanced and is available separately; see the MPICH download page http://www.mcs.anl/gov/mpi/mpich/download.html.
The MPE library for logging and program visualization has been much improved. See the file mpe/README for more details.
A new version of ROMIO, 1.0.3, is included. See romio/README for details.
A new version of the C++ interface from the University of Notre Dame is also included.
Known problems and bugs with this release are documented in the file mpich/KnownBugs .
There is an FAQ at http://www.mcs.anl.gov/mpi/mpich/faq.html . See this if you get "permission denied", "connection reset by peer", or "poll: protocol failure in circuit setup" when trying to run MPICH.
There is a paper on jumpshot available at ftp://ftp.mcs.anl.gov/pub/mpi/jumpshot.ps.gz . A paper on MPD is available at ftp://ftp.mcs.anl.gov/pub/mpd.ps.gz.
Full MPI 1.2 compliance, including cancel of sends
IMPI (Interoperable MPI [2]) style flow control.
A Windows NT version is now available as open source. The installation and use for this version is different; this manual covers only the Unix version of mpich.
Support for SMP-clusters in mpirun.
A Fortran 90 MPI module (actually two, see Section Fortran 90 and the MPI module ).
Support for MPI_INIT_THREAD (but only for MPI_THREAD_SINGLE)
Support for VPATH-style installations, along with a installation process and choice of directory names that is closer to the GNU-recommended approach
A new, scalable log file format, SLOG, for use with the MPE logging tools. SLOG files can be read by a new version of Jumpshot which is included with this release.
Updated ROMIO
A new device for networked clusters, similar to the p4 device but based on daemons and thus supporting a number of new convenience features, including fast startup. See Section Fast Startup with the Multipurpose Daemon and the ch_p4mpd for details.
The ROMIO subsystem implements a large part of the MPI-2 standard for parallel I/O. For details on what types of file systems runs on and current limitations, see the Romio documentation in romio/doc.
The MPI-2 standard C++ bindings are available for the MPI-1 functions.
A new Globus device, globus2, is available. It replaces the previous globus device. See Section Computational Grids: the globus2 device and Appendix mpirun and Globus .
A new program visualization program, called Jumpshot, is available as an alternative to the upshot and nupshot programs.