Intel® MPI Library Developer Reference for Linux* OS

ID 768732
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Compilation Environment Variables

I_MPI_{CC,CXX,FC,F77,F90}_PROFILE

Specify the default profiling library.

Syntax

I_MPI_CC_PROFILE=<profile-name>

I_MPI_CXX_PROFILE=<profile-name>

I_MPI_FC_PROFILE=<profile-name>

I_MPI_F77_PROFILE=<profile-name>

I_MPI_F90_PROFILE=<profile-name>

Argument

<profile-name> Specify a default profiling library.

Description

Set this environment variable to select a specific MPI profiling library to be used by default. This has the same effect as using -profile=<profile-name> as an argument for mpiicc or another Intel® MPI Library compiler wrapper.

I_MPI_TRACE_PROFILE

Specify the default profile for the -trace option.

Syntax

I_MPI_TRACE_PROFILE=<profile-name>

Argument

<profile-name> Specify a tracing profile name. The default value is vt.

Description

Set this environment variable to select a specific MPI profiling library to be used with the -trace option of mpiicc or another Intel MPI Library compiler wrapper.

The I_MPI_{CC,CXX,F77,F90}_PROFILE environment variable overrides I_MPI_TRACE_PROFILE.

I_MPI_CHECK_PROFILE

Specify the default profile for the -check_mpi option.

Syntax

I_MPI_CHECK_PROFILE=<profile-name>

Argument

<profile-name> Specify the checking profile name. The default value is vtmc.

Description

Set this environment variable to select a specific MPI checking library to be used with the -check_mpi option to mpiicc or another Intel MPI Library compiler wrapper.

The I_MPI_{CC,CXX,F77,F90}_PROFILE environment variable overrides I_MPI_CHECK_PROFILE.

I_MPI_CHECK_COMPILER

Turn on/off compiler compatibility check.

Syntax

I_MPI_CHECK_COMPILER=<arg>

Arguments

<arg> Binary indicator.
enable | yes | on | 1 Enable checking the compiler.
disable | no | off | 0 Disable checking the compiler. This is the default value.

Description

If I_MPI_CHECK_COMPILER is set to enable, the Intel MPI Library compiler wrapper checks the underlying compiler for compatibility. Normal compilation requires using a known version of the underlying compiler.

I_MPI_{CC,CXX,FC,F77,F90}

Set the path/name of the underlying compiler to be used.

Syntax

I_MPI_CC=<compiler>

I_MPI_CXX=<compiler>

I_MPI_FC=<compiler>

I_MPI_F77=<compiler>

I_MPI_F90=<compiler>

Arguments

<compiler> Specify the full path/name of compiler to be used.
  • I_MPI_CC=<compiler> affects mpiicx and mpicc
  • I_MPI_CXX=<compiler> affects mpiicpx and mpicxx
  • I_MPI_FC=<compiler> affects mpifc
  • I_MPI_F77=<compiler> affects mpif77
  • I_MPI_F90=<compiler> affects mpiifx and mpif90

Description

Set this environment variable to select a specific compiler to be used. Specify the full path to the compiler if it is not located in the search path.

NOTE:
Some compilers may require additional command line options.
NOTE:
The configuration file is sourced if it exists for a specified compiler. See -config for details.

I_MPI_ROOT

Set the Intel MPI Library installation directory path.

Syntax

I_MPI_ROOT=<path>

Arguments

<path> Specify the installation directory of the Intel MPI Library.

Description

Set this environment variable to specify the installation directory of the Intel MPI Library.

NOTE:
If you are using the Visual Studio integration, you may need to use I_MPI_ONEAPI_ROOT.

VT_ROOT

Set Intel® Trace Collector installation directory path.

Syntax

VT_ROOT=<path>

Arguments

<path> Specify the installation directory of the Intel Trace Collector.

Description

Set this environment variable to specify the installation directory of the Intel Trace Collector.

I_MPI_COMPILER_CONFIG_DIR

Set the location of the compiler configuration files.

Syntax

I_MPI_COMPILER_CONFIG_DIR=<path>

Arguments

<path> Specify the location of the compiler configuration files. The default value is <install-dir>/etc

Description

Set this environment variable to change the default location of the compiler configuration files.

I_MPI_LINK

Select a specific version of the Intel MPI Library for linking.

Syntax

I_MPI_LINK=<arg>

Arguments

Argument Library Version
opt Multi-threaded optimized library (with the global lock). This is the default value
dbg Multi-threaded debug library (with the global lock)
opt_mt Multi-threaded optimized library (with per-object lock for the thread-split model)
dbg_mt Multi-threaded debug library (with per-object lock for the thread-split model)

Description

Set this variable to always link against the specified version of the Intel MPI Library.

I_MPI_DEBUG_INFO_STRIP-

Turn on/off the debug information stripping while linking applications statically.

Syntax

I_MPI_DEBUG_INFO_STRIP=<arg>

Arguments

<arg> Binary indicator
enable | yes | on | 1 Turn on. This is the default value
disable | no | off | 0 Turn off

Description

Use this option to turn on/off the debug information stripping while linking the Intel MPI Library statically. Debug information is stripped by default.

I_MPI_{C,CXX,FC,F}FLAGS

Set special flags needed for compilation.

Syntax

I_MPI_CFLAGS=<flags>

I_MPI_CXXFLAGS=<flags>

I_MPI_FCFLAGS=<flags>

I_MPI_FFLAGS=<flags>

Arguments

<flags> Flag list

Description

Use this environment variable to specify special compilation flags.

I_MPI_LDFLAGS

Set special flags needed for linking.

Syntax

I_MPI_LDFLAGS=<flags>

Arguments

<flags> Flag list

Description

Use this environment variable to specify special linking flags.

I_MPI_FORT_BIND

Disable mpiicc linking with Fortran bindings.

Syntax

I_MPI_FORT_BIND=<arg>

Arguments

<arg> Binary indicator
enable | yes | on | 1 Enable linking. This is the default value
disable | no | off | 0 Disable linking

Description

By default, the mpiicc also links against the Fortran bindings even if Fortran is not used. Use this environment variable to change this default behavior. Has the same effect as the -nofortbind option.