mpicxx

Compiles and links MPI programs written in C++

Description

This command can be used to compile and link MPI programs written in C++. It provides the options and any special libraries that are needed to compile and link MPI programs.

It is important to use this command, particularly when linking programs, as it provides the necessary libraries.

Command line arguments

-show
Show the commands that would be used without runnning them
-help
Give short help
-cxx=name
Use compiler name instead of the default choice. Use this only if the compiler is compatible with the MPICH library (see below)
-config=name
Load a configuration file for a particular compiler. This allows a single mpicxx command to be used with multiple compilers.
-compile_info
Show the steps for compiling a program. This option can be used to see what options and include paths are used by mpicxx.
-link_info
Show the steps for linking a program. This optoin can be used to see what options and libraries are used by mpicxx.
-echo
Show exactly what this program is doing. This option should normally not be used.
others
are passed to the compiler or linker. For example, -c causes files to be compiled, -g selects compilation with debugging on most systems, and -o name causes linking with the output executable given the name name.

Environment Variables

The environment variables MPICH_CXX may be used to select different C++ compiler and linker. Note that since MPICH is built with a particular C and Fortran compiler, changing the compilers used can cause problems. Use this only if you could intermix code compiled with the different compilers.

Compatible Compilers

The MPI library may be used with any compiler that uses the same lengths for basic data objects (such as long double) and that uses compatible run-time libraries. On many systems, the various compilers are compatible and may be used interchangably. There are exceptions; if you use the MPICH_CXX environment variable or the -cxx=name command-line argument to override the choice of compiler and encounter problems, try reconfiguring MPICH2 with the new compiler, and installing MPICH2 in a separate location. See the installation manual for more details.

Examples

To compile a single file foo.c, use
   mpicxx -c foo.cxx

To link the output and make an executable, use

   mpicxx -o foo foo.o
Combining compilation and linking in a single command
   mpicxx -o foo foo.cxx
is a convenient way to build simple programs.

See Also

mpif77, mpicxx, mpif90, mpiexec

Location:mpicxx.txt