MPI_Comm_spawn 函数

生成最多单个 MPI 应用程序的 maxprocs 实例。

语法

int MPIAPI MPI_Comm_spawn(
  _In_  char                        *command,
  _In_  char                        *argv[],
        int                         maxprocs,
        MPI_Info                    info,
        int                         root,
        MPI_Comm                    comm,
  _Out_ MPI_Comm                    *intercomm,
        _Out_opt_cap_(maxprocs) int array_of_errcodes[]
);

参数

  • 命令 [in]
    要生成的程序的名称。

  • argv [in]
    命令的参数。

  • maxprocs
    要启动的最大进程数。

  • info
    一组键值对,告知运行时系统在何处以及如何启动进程。

  • root
    检查先前参数的进程排名。

  • comm
    包含一组生成进程的内部通信器。

  • intercomm [out]
    原始组和新生成的组之间的通信器。

  • array_of_errcodes
    每个进程一个代码。

返回值

返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。

在 Fortran 中,返回值存储在 IERROR 参数中。

Fortran

    MPI_COMM_SPAWN(COMMAND, ARGV, MAXPROCS, INFO, ROOT, COMM, INTERCOMM,
                ARRAY_OF_ERRCODES, IERROR)
        CHARACTER*(*) COMMAND, ARGV(*)
        INTEGER INFO, MAXPROCS, ROOT, COMM, INTERCOMM, ARRAY_OF_ERRCODES(*),
        IERROR

要求

产品

HPC Pack 2012 MS-MPI 可再发行程序包、HPC Pack 2008 R2 MS-MPI 可再发行程序包、HPC Pack 2008 MS-MPI 可再发行程序包或 HPC Pack 2008 客户端实用工具

标头

Mpi.h;Mpif.h

Msmpi.lib

DLL

Msmpi.dll

另请参阅

MPI 进程管理功能