Compiling an MPI Program

This topic describes the basic steps required to compile and link an MPI program, using the Intel® MPI Library SDK.

To simplify linking with MPI library files, Intel MPI Library provides a set of compiler wrapper scripts with the mpi prefix for all supported compilers. To compile and link an MPI program, do the following:

  1. Make sure you have a compiler in your PATH environment variable. For example, to check if you have the Intel® C/C++ Compiler, enter the command:

    > icl

    If the command is not found, add the full path to your compiler into the PATH. For Intel® compilers, you can run the compilervars.bat script to set the required environment variables.

  2. In the same command-line session, run the mpivars.bat script to set up the proper environment for Intel MPI Library:

    > <installdir>\intel64\bin\mpivars.bat

  3. Compile your MPI program using the appropriate compiler wrapper script. For example, to compile a C program with the Intel® C Compiler, use the mpiicc script as follows:

    > mpiicc myprog.c

You will get an executable file myprog.exe in the current directory, which you can start immediately. For instructions of how to launch MPI applications, see Running an MPI Program.

Note

By default, the resulting executable file is linked with the multi-threaded optimized library. If you need to use another library configuration, see Selecting Library Configuration.

For details on the available compiler wrapper scripts, see the Developer Reference.

Compiling an MPI/OpenMP* Program

To compile a hybrid MPI/OpenMP* program using the Intel® compiler, use the /Qopenmp option. For example:

> mpiicc /Qopenmp test.c

This enables the underlying compiler to generate multi-threaded code based on the OpenMP* pragmas in the source. For details on running such programs, refer to Running an MPI/OpenMP* Program.

Test MPI Programs

Intel® MPI Library comes with a set of source files for simple MPI programs that enable you to test your installation. Test program sources are available for all supported programming languages and are located at <installdir>\test, where <installdir> is C:\Program Files (x86)\IntelSWTools\compilers_and_libraries_<version>\windows\mpi by default.

See Also

Intel® MPI Library Developer Reference, section Command Reference > Compiler Commands