Intel® MPI Library Developer Reference for Windows* OS

ID 768734
Date 7/13/2023
Public

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

Compilation Command Options

-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 <install-dir>\etc.

You can create your own profile as <install-dir>\etc\<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 <install-dir>\etc\myprof.conf with the following lines:

SET PROFILE_PRELIB=<path_to_myprof>\lib\myprof.lib
SET 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.

To use this option, include the installation path of the Intel® Trace Collector in the VT_ROOT environment variable. Source the vars. bat script provided in the Intel® Trace Analyzer and Collector installation folder.

-check_mpi

Use this option to link the resulting executable file against the Intel® Trace Collector correctness checking library. The default value is libVTmc.so.

To use this option, include the installation path of the Intel Trace Collector in the VT_ROOT environment variable. Source the vars. bat script provided in the Intel® Trace Analyzer and Collector installation folder.

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

If you specify the -i8 option for the Intel Fortran Compiler, you still have to use the ilp64 option for linkage.

-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, such as-Zi.

/Zi, /Z7 or /ZI

Use these options to compile a program in debug mode and link the resulting executable against the debugging version of the Intel MPI Library. See I_MPI_DEBUG for information on how to use additional debugging features with the /Zi, /Z7, /ZI or debug builds.

The /ZI option is only valid for C/C++ compiler.

-O

Use this option to enable compiler optimization.

Setting this option triggers a call to the libirc library. Many of those library routines are more highly optimized for Intel microprocessors than for non-Intel microprocessors.

-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.bat -show test.obj

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}=<compiler>

Use this option to select the underlying compiler.

The table below lists the recommended product default LLVM and IL0 compiler options and commands used to invoke them.

LLVM Compiler Options for Intel® oneAPI
Language/Model Product Name Compiler Driver Compiler Wrapper Command Example
C Intel® oneAPI DPC++/C++ Compiler icx mpiicc -cc=icx > mpicc -cc=icl.exe -c test.c
C++ Intel® oneAPI DPC++/C++ C icpx mpiicpc -cxx=icpx > mpiicpc -cxx=icpx -c test.cpp
SYCL* Intel® oneAPI DPC++/C++ Compiler > icx-cl -fsycl mpiicpc > -cxx=icx -fsycl > mpiicpc -cxx=icpx -fsycl -c test.cpp
Fortran Intel® oneAPI Fortran Compiler ifx mpiifort -fc=ifx > mpiifort -fc=ifx -c test.
NOTE:
Make sure that the wrapper name is in your PATH. Alternatively, you can specify the full path to the compiler.

NOTE: This option works only with the mpiicc.bat and the mpifc.bat commands.

-v

Use this option to print the compiler wrapper script version.

-norpath

Use this option to disable rpath for the compiler wrapper for the Intel® MPI Library.