mpiexec 命令

常用示例

说明

mpiexec is the standard MPI process launcher defined by the MPI-2 specification. It starts a parallel MPI job by spawning the requested number of processes (ranks) and arranging the communication infrastructure between them. The exact implementation depends on which MPI is installed: MPICH / Hydra, Open MPI, Intel MPI, and others all provide an mpiexec binary with overlapping but not identical option sets. mpiexec also supports MPMD (Multiple Program, Multiple Data) jobs, in which several executables run together as one MPI world by separating their arguments with a colon (:). On most implementations mpirun is a synonym (sometimes the canonical name) for mpiexec; the two are interchangeable for the common cases.

参数

-n _num_, -np _num_

Number of processes (ranks) to launch.

-f _hostfile_, -machinefile _hostfile_

File listing nodes (and optional slot counts) to use.

-host _hostlist_

Comma-separated list of hosts.

-hosts _hostlist_

Same as -host (Open MPI).

-ppn _num_, -perhost _num_

Processes per node.

-wdir _dir_

Working directory for launched processes.

-env _var_ _value_

Set an environment variable for this command segment.

-genv _var_ _value_

Set an environment variable globally for all segments.

-envlist _list_

Forward the named variables from the launching environment.

-bind-to _target_

Bind processes (core, socket, numa, none).

-map-by _policy_

Process placement policy (slot, node, socket, numa, ...).

-x _VAR_

Open MPI: export environment variable to remote processes.

-info

Print build/configuration information for the MPI runtime.