This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "MPICH primary repository". The branch, master has been updated via d5822be073237589fbb2c9670e94420bdfd63cbf (commit) from bc39d1b02dec4719db957286fb17f3730100da8e (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.mpich.org/mpich.git/commitdiff/d5822be073237589fbb2c9670e94420bdf... commit d5822be073237589fbb2c9670e94420bdfd63cbf Author: Ken Raffenetti <[email protected]> Date: Wed Feb 19 13:27:35 2014 -0600 Update README with ABI compatibility info Provide some guidance on how to run MPICH programs using Intel's MPI package and vice-versa. Signed-off-by: Pavan Balaji <[email protected]> (includes some clarifications to the text from Pavan Balaji). diff --git a/README.vin b/README.vin index a343d0f..cf23510 100644 --- a/README.vin +++ b/README.vin @@ -26,6 +26,7 @@ information on bug fixes and new releases. 8. Fault Tolerance 9. Developer Builds 10. Multiple Fortran compiler support +11. ABI Compatibility ------------------------------------------------------------------------- @@ -788,3 +789,80 @@ Fortran program compiled/linked by another fortran compiler, say pgf77, say through mpif77 -f77=pgf77. As long as the Fortran program is linked without any errors by one of these compilers, the program shall be running fine. + +------------------------------------------------------------------------- + +11. ABI Compatibility +===================== + +The MPICH ABI compatibility initiative was announced at SC 2014 +(http://www.mpich.org/abi). As a part of this initiative, Argonne, +Intel, IBM and Cray, have committed to maintaining ABI compatibility +with each other. + +As a first step in this initiative, starting with version 3.1, MPICH +is binary (ABI) compatible with Intel MPI 5.0. This means you can +build your program with one MPI implementation and run with the other. +Specifically, binary-only applications that were built and distributed +with one of these MPI implementations and now be executed with the +other MPI implementation. + +Some setup is required to achieve this. Below details how to +accomplish this. + +To run an MPICH-built program with Intel: +---------------------------------------- + +1. The current MPI library names do not currently match. This is + planned to be fixed in the future, but for now, you need to employ + some symbolic links in order for the linker to find the necessary + libraries correctly. We recommend doing this in a separate + directory. + + For applications built with the default Intel MPI configuration: + + ln -s /path/to/intel/lib/libmpi.so libmpich.so.12 + ln -s /path/to/intel/lib/libmpigc4.so libmpichcxx.so.12 + ln -s /path/to/intel/lib/libmpigf.so libfmpich.so.12 + ln -s /path/to/intel/lib/libmpigf.so libmpichf90.so.12 + ln -s /path/to/intel/lib/libmpi.so libmpl.so.1 + ln -s /path/to/intel/lib/libmpi.so libopa.so.1 + + For applications built with the debug configuration of Intel MPI: + + ln -s /path/to/intel/lib/libmpi_dbg.so libmpich.so.12 + ln -s /path/to/intel/lib/libmpigc4.so libmpichcxx.so.12 + ln -s /path/to/intel/lib/libmpigf.so libfmpich.so.12 + ln -s /path/to/intel/lib/libmpigf.so libmpichf90.so.12 + ln -s /path/to/intel/lib/libmpi_dbg.so libmpl.so.1 + ln -s /path/to/intel/lib/libmpi_dbg.so libopa.so.1 + +2. Add directory to LD_LIBRARY_PATH + + export LD_LIBRARY_PATH=/path/to/symlinks:$LD_LIBRARY_PATH + +3. For Fortran programs, you must also modify LD_PRELOAD + + export LD_PRELOAD=/path/to/intel/lib/libmpi.so:/path/to/intel/lib/libmpigf.so:$LD_PRELOAD + +4. Run your program + + /path/to/intel/bin/mpiexec <mpi_program> + +To run an Intel-built program with MPICH: +---------------------------------------- + +1. Create symlinks + + ln -s /path/to/mpich/lib/libmpich.so libmpi.so.5 + ln -s /path/to/mpich/lib/libmpich.so libmpi_dbg.so.5 + ln -s /path/to/mpich/lib/libmpichcxx.so libmpigc4.so.5 + ln -s /path/to/mpich/lib/libmpichf90.so libmpigf.so.5 + +2. Modify LD_LIBRARY_PATH + + export LD_LIBRARY_PATH=/path/to/symlinks:$LD_LIBRARY_PATH + +3. Run your program + + /path/to/mpich/bin/mpiexec <mpi_program> ----------------------------------------------------------------------- Summary of changes: README.vin | 78 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 78 insertions(+), 0 deletions(-) hooks/post-receive -- MPICH primary repository