Developer Reference

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 tables below list the available 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*/DPC++
Intel® oneAPI DPC++/C++ Compiler
dpcpp
mpiicpc
-cxx=dpcpp
>
mpiicpc -cxx=dpcpp -c test.cpp
Fortran
Intel® oneAPI Fortran Compiler
ifx
mpiifort
-fc=ifx
>
mpiifort -fc=ifx -c test.
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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.