User's Guide for mpich, a Portable Implementation of MPI

William Gropp and Ewing Lusk

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 computing environments. This paper describes how to build and run MPI programs using the mpich implementation of MPI. Contents

Contents

  • Introduction
  • Linking and running programs
  • The mpicc and mpif77 commands
  • Running with mpirun
  • More detailed control
  • Special features of different systems
  • Difference between workstation clusters and MPPs
  • Checking your machines list
  • Using the secure server
  • Tuning the P4 device
  • Heterogeneous networks and the ch_p4 device
  • Using special switches
  • Heterogeneous networks of multicomputers and the ch_nexus device
  • MPPs
  • IBM SPx
  • Intel Paragon
  • Symmetric Multiprocessors (SMPs)
  • The Convex Exemplar SPP
  • Sample MPI programs
  • The MPE library of useful extensions
  • Creating logfiles
  • Parallel X Graphics
  • Other  mpe routines
  • Profiling libraries
  • Accumulation of time spent in MPI routines
  • Logfile creation and upshot
  • Real-time animation
  • Accessing the profiling libraries
  • Automatic generation of profiling libraries
  • Tools for Profiling Library Management
  • Examining event logs with  upshot
  • Debugging MPI programs
  • Error handlers
  • Command-line arguments for  mpirun
  • MPI arguments for the application program
  • p4 arguments for debugging
  • Debugging for Nexus
  • Command-line arguments for the application program
  • Starting jobs with a debugger
  • Starting the debugger when an error occurs
  • Attaching debugger to a running program
  • Related tools
  • Contents of the library files
  • Other MPI Documentation
  • In case of trouble
  • Problems compiling or linking Fortran programs
  • General
  • Problems linking C programs
  • General
  • Sun Solaris
  • HPUX
  • Problems starting programs
  • General
  • Workstation Networks
  • Intel Paragon
  • IBM RS6000
  • IBM SP
  • Programs fail at startup
  • General
  • Workstation Networks
  • Programs fail after starting
  • General
  • HPUX
  • Trouble with Input and Output
  • General
  • IBM SP
  • Workstation Networks
  • Upshot and Nupshot
  • General
  • HP-UX
  • Appendices
  • Automatic generation of profiling libraries
  • Writing wrapper definitions
  • Options for  mpirun
  • Acknowledgments
  • Bibliography