Compilation Command Options

-nostrip

Use this option to turn off the debug information stripping while linking the Intel® MPI Library statically.

Use this option to source a compiler configuration file. The file should contain the environment settings to be used with the specified compiler.

Use the following naming convention for configuration files:

<installdir>/intel64/etc/mpi<compiler>-<name>.conf

where:

<compiler> = {cc,cxx,f77,f90}, depending on the language compiled.
<name> is the name of the underlying compiler with spaces replaced by hyphens; for example, the <name> value for cc -64 is cc--64.

-profile=<profile_name>

Use this option to specify an MPI profiling library. <profile_name> is the name of the configuration file (profile) that loads the corresponding profiling library. The profiles are taken from <installdir>/<arch>/etc.

Intel® MPI Library comes with several predefined profiles for the Intel® Trace Collector:

<installdir>/<arch>/etc/vt.conf – regular tracing library
<installdir>/<arch>/etc/vtfs.conf – fail-safe tracing library
<installdir>/<arch>/etc/vtim.conf – load imbalance tracing library

You can also create your own profile as <profile_name>.conf. You can define the following environment variables in a configuration file:

PROFILE_PRELIB – libraries (and paths) to load before the Intel® MPI Library
PROFILE_POSTLIB – libraries to load after the Intel® MPI Library
PROFILE_INCPATHS – C preprocessor arguments for any include files

For example, create a file myprof.conf with the following lines:

PROFILE_PRELIB="-L<path_to_myprof>/lib -lmyprof"
PROFILE_INCPATHS="-I<paths_to_myprof>/include"

Use the -profile=myprof option for the relevant compiler wrapper to select this new profile.

-t or -trace

Use the -t or -trace option to link the resulting executable file against the Intel® Trace Collector library. Using this option has the same effect as the -profile=vt option.

You can also use the I_MPI_TRACE_PROFILE environment variable to <profile_name> to specify another profiling library. For example, set I_MPI_TRACE_PROFILE to vtfs to link against the fail-safe version of the Intel® Trace Collector.

To use this option, include the installation path of the Intel® Trace Collector in the VT_ROOT environment variable. Source the itacvars.[c]sh script provided in the Intel® Trace Analyzer and Collector installation folder.

-trace-imbalance

Use the -trace-imbalance option to link the resulting executable file against the load imbalance tracing library of Intel® Trace Collector. Using this option has the same effect as the -profile=vtim option.

-ilp64

Use this option to enable partial ILP64 support. All integer arguments of the Intel MPI Library are treated as 64-bit values in this case.

-no_ilp64

Use this option to disable the ILP64 support explicitly. This option must be used in conjunction with -i8 option of Intel® Fortran Compiler.

Note

If you specify the -i8 option for the separate compilation with Intel® Fortran Compiler, you still have to use the i8 or ilp64 option for linkage.

-dynamic_log

Use this option in combination with the -t option to link the Intel® Trace Collector library dynamically. This option does not affect the default linkage method for other libraries.

To run the resulting programs, include $VT_ROOT/slib in the LD_LIBRARY_PATH environment variable.

-g

Use this option to compile a program in debug mode and link the resulting executable file against the debugging version of the Intel® MPI Library. See I_MPI_DEBUG for information on how to use additional debugging features with the -g builds.

Note

The optimized library is linked with the -g option by default.

Note

Use mpivars.{sh|csh} [debug|debug_mt] at runtime to load a particular libmpi.so configuration.

-link_mpi=<arg>

Use this option to always link the specified version of the Intel® MPI Library. See the I_MPI_LINK environment variable for detailed argument descriptions. This option overrides all other options that select a specific library.

Note

Use mpivars.{sh|csh}[debug|debug_mt] during runtime to load particular libmpi.so configuration.

-O

Use this option to enable compiler optimization.

-fast

Use this option to maximize speed across the entire program. This option forces static linkage method for the Intel® MPI Library.

Note

This option is supported only by the mpiicc, mpiicpc, and mpiifort Intel® compiler wrappers.

-echo

Use this option to display everything that the command script does.

-show

Use this option to learn how the underlying compiler is invoked, without actually running it. Use the following command to see the required compiler flags and options:

$ mpiicc -show -c test.c

Use the following command to see the required link flags, options, and libraries:

$ mpiicc -show -o a.out test.o

This option is particularly useful for determining the command line for a complex build procedure that directly uses the underlying compilers.

-show_env

Use this option to see the environment settings in effect when the underlying compiler is invoked.

-{cc,cxx,fc,f77,f90}=<compiler>

Use this option to select the underlying compiler.

For example, use the following command to select the Intel® C++ Compiler:

$ mpicc -cc=icc -c test.c

Make sure icc is in your PATH. Alternatively, you can specify the full path to the compiler.

-nofortbind, -nofortran

Use this option to disable mpiicc linking with Fortran bindings. Has the same effect as the I_MPI_FORT_BIND variable.

-v

Use this option to print the compiler wrapper script version and its underlying compiler version.