Visible to Intel only — GUID: GUID-1997534E-3296-40D3-A0A7-FC6AD035277E
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.
| 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.
Parent topic: Compiler Commands