User's Guide for MPE: Extensions for MPI Programs

William Gropp and Ewing Lusk

The MPE extensions provide a number of useful facilites for MPI programmers. These include several profiling libraries to collect information on MPI programs, including logfiles for post-mortum visualization and real-time animation. Also included are routines to provide simple X window system graphics to parallel programs. MPE may be used with any implemenation of MPI.


Contents

  • Introduction
  • The MPE library of useful extensions
  • Logfile Creation
  • Logfile Format
  • Parallel X Graphics
  • Other MPE Routines
  • Profiling Libraries
  • Accumulation of Time Spent in MPI routines
  • Automatic Logging
  • Customized Logging
  • Real-Time Animation
  • Logfile Viewers
  • Upshot and Nupshot
  • Jumpshot-2 and Jumpshot-3
  • Accessing the profiling libraries
  • Automatic generation of profiling libraries
  • Tools for Profiling Library Management
  • Using MPE
  • Introduction
  • Directory Structure
  • Example Makefile
  • Environmental Variables
  • Utility Programs
  • Log Format Converters
  • Log Format Print Programs
  • Display Program Selector
  • Using MPE in MPICH
  • Compilation and Linkage
  • Inheritance of Environmental Variables
  • Viewing Logfiles
  • Debugging MPI programs with built-in tools
  • Error handlers
  • Contents of the library files
  • Appendices
  • Installing MPE
  • Configuration
  • Configuration Model
  • Build Options and Features
  • Installation Instructions
  • Configuring as part of the MPICH configure
  • Configuring as part of an existing MPI implementation
  • Install/Uninstall Scripts
  • Installing Java for Jumpshots
  • viewers
  • Automatic generation of profiling libraries
  • Writing wrapper definitions
  • Manual Pages
  • Acknowledgments
  • Bibliography