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
  檢查先前引數的進程排名。

• 通訊
  包含繁衍進程群組的 Intracommunicator。

• 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 進程管理功能