要在 Visual C++.NET 中撰寫 MPI 程式,除了裝好 MPICH SDK,還有幾個專案屬性與環境變數必須先設定妥當。這些步驟做一次三分鐘,之後每支程式都能直接受益。本文以一支最基本的 Hello World 為例,把設定與程式碼完整走一遍。
建立空的控制台專案之後,進入專案屬性,依序完成四件事:
E:\Program Files\MPICH\SDK\IncludeE:\Program Files\MPICH\SDK\LibMPIRun.exe 的路徑。這個設定的目的是讓按 F5 就能直接啟動 MPI 執行環境,不必每次手動開命令提示字元。-np 4 $(TargetPath)-np 4 表示啟動 4 個 process,$(TargetPath) 是組建輸出的執行檔路徑巨集。最後別忘了在「我的電腦 → 內容 → 進階 → 環境變數」的 PATH 中,加入 MPICH 的 bin 目錄,例如 E:\PROGRA~1\MPICH\mpd\bin。少了這步,mpiexec / mpd 相關工具會找不到。
#include <mpi.h>
#include <stdlib.h>
#include <stdio.h>
#include <conio.h>
#pragma comment (lib, "mpichd.lib")
int main(int argc, char* argv[])
{
int myid, numprocs;
int namelen;
char processor_name[MPI_MAX_PROCESSOR_NAME];
MPI_Init(&argc, &argv);
MPI_Comm_rank(MPI_COMM_WORLD, &myid);
MPI_Comm_size(MPI_COMM_WORLD, &numprocs);
MPI_Get_processor_name(processor_name, &namelen);
fprintf(stderr,
"Hello World! Process %d of %d on %s\n",
myid, numprocs, processor_name);
MPI_Finalize();
if (myid == 0)
{
printf("\nPress a key and exit.\n");
getch();
}
return 0;
}
MPI_Init / MPI_Finalize 是一對必須成對出現的呼叫。MPI_Init 之前不能呼叫任何 MPI 函式,MPI_Finalize 之後同樣不行。它們負責初始化執行環境與回收資源。
MPI_Comm_rank 取得「我是誰」——目前 process 在指定 communicator 中的 rank(編號,從 0 開始)。MPI_Comm_size 則取得「總共有幾人」——該 communicator 內的 process 總數。這兩個值是所有 MPI 程式判斷分支的基礎。
MPI_Get_processor_name 回傳執行這個 process 的機器名稱。在多台機器組成的叢集裡,這個資訊用來確認 MPI 的負載分配是否符合預期,非常實用。
MPI_COMM_WORLD 是預設的 communicator,包含所有由這次 mpiexec 啟動的 process。MPI 的 communicator 概念類似「工作群組」:通訊只在群組內進行,後續要進一步學習的 MPI_Comm_split 就是拿來切分群組用的。
範例中刻意把 getch() 只放在 rank 0 執行。這是因為在 Windows 上透過 MPIRUN 啟動時,主控視窗可能在程式結束後立刻關閉,看不到輸出。只讓 0 號 process 等待按鍵,就能把視窗留住又不影響其他 process。
連結錯誤(LNK)找不到 mpi.h 或 mpichd.lib:檢查 include / lib 路徑是否指向正確的 SDK 版本。注意 debug 版通常連結 mpichd.lib,release 版則是 mpich.lib,用錯會找不到符號。
執行時只跑起一個 process:多半是命令參數沒設定,或 -np 後的數字與 $(TargetPath) 之間少了空格。
提示找不到 mpiexec / smpd:PATH 沒設好。MPICH2 在 Windows 上需要先啟動 SMPD 服務(smpd -install 然後 smpd -start),這個步驟常被遺漏。
輸出順序凌亂:這是正常的。多個 process 同時寫 stderr,先後順序不 guarantee。這裡刻意用 stderr 而非 stdout,就是為了讓輸出即時可見、不被緩衝。
這支程式只是確認環境可用。真正的 MPI 學習起點是 MPI_Send / MPI_Recv 這對點對點通訊函式,以及 MPI_Bcast、MPI_Reduce 這類集合通訊。建議先把 rank 與 size 這兩個值玩熟——大部分 MPI 程式的骨架都是「依 rank 分支,各自做不同的工作,需要時再交換資料」。