Intel® MPI Library

Developer Guide for Linux* OS

Download PDF
ID 768728
Date 6/30/2025
Public
Document Table of Contents
Document Table of Contents x
Developer Guide for Linux* OS
Developer Guide for Linux* OS x
Introduction Installation and Prerequisites Compiling and Linking Running Applications Debugging Applications Analysis and Tuning Troubleshooting Additional Supported Features Examples Notices and Disclaimers
Introduction x
Introducing Intel® MPI Library Conventions and Symbols Related Information
Installation and Prerequisites x
Installation Prerequisite Steps
Compiling and Linking x
Compiling an MPI Program Compilers Support ILP64 Support
Running Applications x
Running Intel® MPI Library in Containers Selecting a Library Configuration Running an MPI Program Running an MPI/OpenMP* Program MPMD Launch Mode Fabrics Control Job Schedulers Support Controlling Process Placement Java* MPI Applications Support
Running Intel® MPI Library in Containers x
Build a Singularity* Container for an MPI Application Run the Application with a Container
Fabrics Control x
Selecting Fabrics Libfabric* Support Enabling Libfabric Support Supported Providers See Also OFI* Providers Support
Debugging Applications x
Debugging Using -gtool for Debugging
Analysis and Tuning x
Displaying MPI Debug Information Tracing Applications Interoperability with Other Tools Through -gtool MPI Tuning
Troubleshooting x
Error Message: Bad Termination Error Message: No such file or Directory Error Message: Permission Denied Error Message: Fatal Error Error Message: Bad File Descriptor Error Message: Too Many Open Files Error Message: Too Many Communicators Problem: High Memory Consumption Readings Problem: MPI Application Hangs Problem: Password Required Problem: Cannot Execute Binary File Problem: MPI limitation for Docker*
Additional Supported Features x
Asynchronous Progress Control Device-Initiated Communications Notified One-Sided Communications Multiple Endpoints Support
Multiple Endpoints Support x
MPI_THREAD_SPLIT Programming Model Threading Runtimes Support Program Examples Code Change Guide
Examples x
async_progress_sample.c thread_split.cpp thread_split_omp_for.c thread_split_omp_task.c thread_split_pthreads.c
Developer Guide for Linux* OS

Libfabric* Support

The Intel® MPI Library switched from the Open Fabrics Alliance* (OFA) framework to the Open Fabrics Interfaces* (OFI) framework and currently supports libfabric*.

Enabling Libfabric Support

By  default, the script that sets the environmental variables (vars.sh)  sets the environment to libfabric shipped with the Intel MPI Library. To disable this, use the I_MPI_OFI_LIBRARY_INTERNAL environment variable or the -i_mpi_ofi_internal option passed to the script: 

# Do not set the environment to libfabric from the Intel MPI Library.
$ source <install-dir>/env/vars.sh -i_mpi_ofi_internal=0

# Set the environment to libfabric from the Intel MPI Library.
$ source <install-dir>/env/vars.sh -i_mpi_ofi_internal=1 

# A short form of -ofi-internal=1
$ source <install-dir>/env/vars.sh
NOTE:
Set the I_MPI_DEBUG environment variable to 1 before running an MPI application to see the libfabric version and provider.

Example

$ export I_MPI_DEBUG=1
$ mpiexec -n 1 IMB-MPI1 -help
[0] MPI startup(): libfabric version: 1.5.0
[0] MPI startup(): libfabric provider: psm2


...

Supported Providers

  • psm3
  • efa
  • tcp
  • shm
  • psm2
  • mlx
  • verbs

See Also

Parent topic: Fabrics Control
Level Two Title