Developer Reference

  • 2020 Update 2
  • 07/15/2020
  • Public Content

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>

Arguments

<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>

Arguments

<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>

Arguments

<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.

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.
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
<installdir>
/
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

<arg>
Version of library
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.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804