最近几天开始接触MPI编程了，虽然还是一头雾水，没有入门，但是先把自己整理的一些函数贴出来，方便以后查看。

管理函数

Int MPI(int *argc,char **argv)

Int MPI_Finalize(void) 清除MPI的所有状态

Int MPI_Inilialized(int flag) 检查是否调用了MPI_INIT

Int MPI_Error_String(int errorcode,char *string ,int *len) 检查MPI函数错误

进程组操作函数

1.      Int MPI_Comm_group(MPI_Comm comm,MPI_Group *group)

 IN    comm  通信子

 OUT  group   对应comm的进程组

用来建立一个通信子对应的新进程组，之后就可以对此进程组进行需要的操作

 

2.      Int MPI_group_free(MPI_Group *group)

 INOUT   group   释放进程组并返回MPI_Group_NULL

调用MPI_Group_free之后，任何关于此进程组的操作都视为无效

 

3.      Int MPI_Group_size(MPI_Group group,int *size)

IN   Group  进程组

OUT  size    进程组中的进程个数

如果进程组是MPI_Group_Empty，则返回值size为0

4.      Int MPI_Group_rank(MPI_Group group,int *rank)

IN    Group     进程组

OUT  Rank      进程在进程组中的编号

如果进程不是进程组中的成员，则返回值RANK为MPI_UNDEFINED

5.      Int MPI_Group_translate_ranks(MPI_Group  group1,int n,int *ranks1,MPI_Group group2,int *ranks2)

IN     Group1     进程组1

IN     n          ranks1和ranks2中数组元素的个数

IN     ranks1      进程组1中有效编号组成的数组

IN     group2      进程组2

OUT   ranks2      ranks1中的元素在进程组2中的对应编号

如果属于进程组1的某个进程可以在ranks1中找到，而这个进程不属于进程组2，则在ranks2中对应ranks1的位置返回值为MPI_UNDEFINED

6.      Int MPI_Group_incl(MPI_Group group,int n,int *ranks,MPI_Group new group)

IN     Group     进程组

IN     n         ranks数组中元素的个数和新进数组的大小

IN     ranks      将在新进程组中出现的旧进程组中的编号

OUT     newgroup   有ranks定义的顺序导出的新进程组

7.      Int MPI_Group_excl(MPI_Group group,int n,int *ranks,MPI_Group newgroup)

IN     group     进程组

IN     N        ranks数组中元素的个数

IN     ranks     在新进程组中不出现的旧进程组中的编号

OUT   newgroup 旧进程组中不在ranks里的元素组成的新进程组

8.      Int MPI_Group_union(MPI_Group group1,MPI_Group group2,MPI_Group newgroup)

IN     group1     进程组1

IN     group2     进程组2

OUT   newgroup  进程组1和进程组2的并

9.      Int MPI_Group_intersection(MPI_Group group1,MPI_Group group2,MPI_Group newgroup)

 IN     group1     进程组1

IN     group2     进程组2

OUT   newgroup  进程组1和进程组2的交

10.  Int MPI_Group_difference(MPI_Group group1,MPI_Group group2,MPI_Group newgroup)

IN     group1     进程组1

IN     group2     进程组2

OUT   newgroup  进程组1和进程组2的差

 

MPI通信子操作

1.      int MPI_Comm_Size(MPI_Comm comm,int *size)

IN     comm     通信子

OUT   size       通信子中的进程个数

2.      int MPI_Comm_rank(MPI_Comm comm,int *rank)

IN     comm     通信子

OUT   rank       通信子中的进程编号

3.      int MPI_Comm_dup(MPI_Comm comm,MPI_Comm *newcomm)

IN     comm     通信子

OUT   newcomm comm通信子的复制

4.      int MPI_Comm_Create(MPI_Comm comm,MPI_Group group,MPI_Comm *newcomm)

IN     comm     通信子

IN     group     通信子comm的一个子集

OUT   newcomm 对应group的一个新通信子

5.      int MPI_Comm_Split(MPI_Comm comm,int color,int key,MPI_Comm *newComm)

IN     comm     通信子

IN     color      子集控制值

IN     key       子集进程编号的顺序

OUT   newcomm  由此产生的新通信子

划分comm所对应的进程组为不相交的子进程组，每个子进程组有一个共同的值color

6.      int MPI_Comm_free(MPI_Comm *Comm)

INOUT     comm     通信子

点到点通信函数

一对进程之间的数据转换，也就是说一边发送数据另一边接收数据，点到点通信是MPI通信机制的基础，它分为同步通信和异步通信二种机制。

阻塞式通信函数

1.      int MPI_send(void *buf,int count,MPI_Datatype datatype,int dest,int tag,MPI_Comm comm)

IN     buf     所要发送消息数据的首地址

IN     count   发送消息数组元素的个数

IN     datatype 发送消息的数据类型

IN     dest    接收消息的进程编号

IN     tag     消息标签

IN     comm  通信子

2.      int MPI_Recv(void *buf,int count,MPI_Datatype datatype,int source,int tag,MPI_Comm comm,MPI_Status *status)

OUT     buf     接收消息数据的首地址

IN       Count   接收消息数组元素的最大个数

IN       datatype 接收消息的数据类型

IN       source   发送消息的进程编号

IN       tag      消息标签

IN       comm    通信子

OUT     status    接收消息时返回的状态

3.      int MPI_Get_Count(MPI_Status status,MPI_Datatype datatype,int *count)

IN     status     接收消息时返回的状态

IN     datatype   接收消息时返回的类型

OUT   Count      接收消息时数组元素的个数

4.      int MPI_Sendrecv(void *sendbuf,int sendcount,MPI_Datatype sendtype,int dest,int sendtag,void *recvbuf,int recvcount,MPI_Datatype recvtype,int source,int recvtag,MPI_Comm comm,MPI_Status *status)

IN     sendbuf     所要发送消息数据的首地址

IN     sendcount   发送消息数组元素的个数

IN     sendtype    发送消息的数据类型

IN     dest        接收消息的进程编号

IN     sendtag     发送消息标签

OUT   recvbuf      接收消息数据的首地址

IN     recvcount    接收消息数组元素的最大个数

IN     recvtype     接收消息的数据类型

IN     Source     发送消息的进程编号

IN     recvtag     接收消息标签

IN     comm      通信子

OUT   status      接收消息时返回的状态

5.      int MPI_Sendrecv_replace(void *sendbuf,int count,MPI_Datatype datatype,int dest,int sendtag,int source,int recving,MPI_Comm comm,MPI_Status *status)

OUT     buf     发送和接收消息数据的首地址

IN       Count   发送和接收消息数组元素的个数

IN       dest    接收消息的进程编号

IN       sendtag 发送消息标签

IN       source   发送消息的进程编号

IN       recvtag  接收消息标签

IN       comm   通信子

OUT     status   接收消息时返回的状态

6.      int MPI_probe(int source,int tag,MPI_Comm comm,MPI_Status *status)

IN     source     发送消息进程的编号

IN     tag        接收消息的标签

IN     comm     通信子

OUT   status      返回到消息的状态

7.      int MPI_Iprobe(int source,int tag,MPI_Comm comm,int *flag,MPI_Status *status)

IN     source     发送消息进程的编号

IN     tag        接收消息的标签

IN     comm     通信子

OUT    flag      如果指定消息已经到达，flag返回值为true

OUT   status     返回到达消息的状态

非阻塞式通信函数

非阻塞式通信函数是指在通信过程中，不需要等待通信结束就返回，通常这种通信过程交由计算机的后台来处理，如果计算机系统提供硬件支持非阻塞式通信函数，就可以使计算与通信在时间上的重叠，从而提高并行计算的效率。

1.      int MPI_Isend(void *buf,int count,MPI_Datatype datatype,int dest,int tag,MPI_Comm comm,MPI_Request *request)

IN     buf     所要发送消息数据的首地址

IN     count   发送消息数组元素的个数

IN     datatype 发送消息的数据类型

IN     dest    接收消息的进程编号

IN     tag     消息标签

IN     comm   通信子

OUT   request  请求句柄一杯将来查询

2.      int MPI_Irecv(void *buf,int count,MPI_Datatype datatype,int source,int tag,MPI_Comm comm,MPI_Request *request)

OUT     buf     接收消息数据的首地址

IN      Count    接收消息数组元素的个数

IN      datatype  接收消息的数据类型

IN      source    发送消息的进程编号

IN      tag       消息标签

IN      comm     通信子

OUT    request    请求句柄以北将来查询

MPI_Isend和MPI_Irecv不需要等待发送或接收消息完成就可以执行其他任务

3.      Int MPI_wait(MPI_Request *request,MPI_Status *status)

INOUT      request     请求句柄

OUT        status      发送或接收消息的状态

如果request所指的操作已经完成，MPI_Wait将结束等待状态

4.      Int MPI_Test(MPI_Request *request,int *flag,MPI_Status *status)

INOUT     request     请求句柄

OUT       flag        request所指的操作已经完成返回值为true

OUT       status      发送或接收消息的状态

5.      Int MPI_Request_free(MPI_Request *request)

INOUT     request     请求句柄，返回值为MPI_Request_null

对单个request进行查询

6.      Int MPI_Waitany(int count,MPI_Request *array_of_requests,int *index,MPI_Status *status)

IN     count     请求句柄的个数

INOUT  array_of_requests 请求句柄数组

OUT    index     已经完成通信操作的句柄指标

OUT    status    消息的状态

当所有请求句柄中至少有一个已经完成通信操作，就返回，如果有多于一个请求句柄已经完成，MPI_waitany将随机选择其中的一个并立即返回

7.      Int MPI_Testany(int Count,MPI_Request *array)

IN     count     请求句柄个数

INOUT  array_of_requests 请求句柄数组

OUT    index     已经完成通信操作的句柄指标

OUT    flag       如果有一个已经完成，则flag=true

OUT    status     消息的状态

无论有没有通信操作完成都将立即返回

8.      Int MPI_Waitall(int Count,MPI_Request *array_of_requests)

IN     count     请求句柄的个数

INOUT  array_of_requests 请求句柄数组

INOUT  array_of_status  所有消息的状态数组

所有通信操作完成之后才返回，否则将一直等待

9.      Int MPI_Testall(int Count,MPI_Request *array_of_requests,int *flag,MPI_Status *array_of_status)

IN     count     请求句柄的个数

INOUT  array_of_requests  请求句柄数组

OUT    flag      如果有一个没完成，则flag=false

INOUT  array_of_status 所有消息的状态数组

无论所有通信操作是否完成都立即返回

10.  Int MPI_Cancel(MPI_Request *request)

INOUT     request     请求句柄

取消一个发送或接收操作

11.  Int MPI_Test_cancelled(MPI_Status *status,int *flag)

IN        status     消息的状态

OUT       flag      如果已经取消，则flag=true

特殊的点到点通信函数

1.      Int MPI_Send_init(void *buf,int count,MPI_Datatype datatype,int dest,int tag,MPI_Comm comm,MPI_Request *request)

IN     buf     所要发送消息数据的首地址

IN     count   发送消息数组元素的个数

IN     datatype 发送消息的数据类型

IN     dest     接收消息的进程编号

IN     tag      消息标签

IN     comm   通信子

OUT   request  请求句柄以备将来查询

2.      Int MPI_Recv_init(void *buf,int count,MPI_Datatype  datatype,int source,int tag,MPI_Comm comm,MPI_Request *request)

OUT     buf     接收消息数据的首地址

IN       count   接收消息数组元素的个数

IN       datatype 接收消息的数据类型

IN       Source   发送消息的进程编号

IN       tag      消息标签

IN       comm   通信子

OUT     request  请求句柄以备将来查询

3.      Int MPI_Start(MPI_Request *request)

   INOUT     request     请求句柄

4.      Int MPI_Startall(int count,MPI_Request *array_of_request)

IN     Count     需要激活的请求句柄个数

INOUT array_of_request  请求句柄数