Obtaining and Unpacking the Distribution


Up: Contents Next: Documentation Previous: Quick Start

mpich can be obtained by anonymous ftp from the site ftp.mcs.anl.gov. Go to the directory pub/mpi and get the file mpich.tar.gz. This file name is a link to the most recent verstion of mpich. Currently it is about four Megabytes in size. The file is a gzipped tar file, so it may be unpacked with

    gunzip -c mpich.tar.gz | tar xovf - 

If you do not have gunzip, but do have uncompress, then you must get mpich.tar.Z instead, and use either
    zcat mpich.tar.Z | tar xovf - 

or
    uncompress mpich.tar.Z 

    tar xvf mpich.tar 

This will create a single directory called mpich, containing in various subdirectories the entire distribution, including all of the source code, some documentation (including this Guide), man pages, the mpich environment described in Section The mpich Programming Environment , and example programs. In particular, you should see the following files and directories:
{ COPYRIGHT}
Copyright statement. This code is free but not public domain. It is copyrighted by the University of Chicago and Mississippi State University.
{ Makefile.in}
Template for the Makefile, which will be produced when you run configure.
{ MPI-2-C++}
The C++ system from Notre Dame. It includes the C++ bindings for the MPI-1 functions.
{ README}
Basic information and instructions for configuring.
{ aclocal.m4}
Used for building configure from configure.in; not needed for most installations. The file aclocal_tcl.m4 is included by aclocal.m4.
{ ccbugs}
Directory for programs that test the C compiler during configuration, to make sure that it will be able to compile the system.
{ configure}
The script that you run to create Makefiles throughout the system.
{ configure.in}
Input to autoconf that produces configure.
{ doc}
Assorted tools for producing documentation, together with this Installation Guide and the User's Guide.
{ examples}
Directory containing further directories of example MPI programs. Of particular note are basic, with a few small examples to try first, test, with a test suite for exercising mpich, and perftest, containing benchmarking code.
{ include}
The include libraries, both user and system.
{ bin}
Contains the programs and executable scripts, such as mpicc and mpirun, used to build and run MPI programs.
{ lib}
Contains the libraries for MPI, MPE, and related tools.
{ man}
Man pages for MPI, MPE, and internal routines.
{ mpe}
The source code for the MPE extensions for logging and X graphics. The contrib directory contains examples. Best are the mandel and mastermind subdirectories. The profiling subdirectory contains the profiling subsystem, including a system for automatically generating the ``wrappers'' for the MPI profiling interface.
{ mpid}
The source code for the various ``devices'' that customize mpich for a particular machine, operating system, and environment.
{ romio}
The ROMIO parallel I/O system, which includes an implementation of most of the MPI-2 parallel I/O standard.
{ jumpshot}
The source for for the Jumpshot performance visualization program (see Section Jumpshot ).
{ src}
The source code for the portable part of mpich. There are subdirectories for the various parts of the MPI specification.
{ util}
Utility programs and files.
{ www}
HTML versions of the man pages.

If you have problems, check the mpich home page on the Web at http://www.mcs.anl.gov/mpi/mpich . This page has pointers to lists of known bugs and patchfiles. If you don't find what you need here, send mail to mpi-bugs@mcs.anl.gov.



Up: Contents Next: Documentation Previous: Quick Start