MPICH C语言接口函数说明

int MPI_Abort(MPI_Comm comm, int errorcode)
　　终止MPI环境及MPI程序的执行

int MPI_Address(void * location, MPI_Aint * address)
　　得到给定位置在内存中的地址，将被废弃的函数，建议用MPI_Get_address取代

int MPI_Allgather(void * sendbuff, int sendcount, MPI_Datatype sendtype, void * recvbuf, int * recvcounts, int * displs, MPI_Datatype recvtype, MPI_Comm comm)
　　每一进程都从所有其它进程收集数据，相当于所有进程都执行了一个MPI_Gather调用。

int MPI_Allgatherv(void * sendbuff, int sendcount, MPI_Datatype sendtype, void * recvbuf, int recvcounts, int * displs, MPI_Datatype recvtype, MPI_Comm comm)
　　所有进程都收集数据到指定的位置，就如同每一个进程都执行了一个MPI_Gatherv调用

int MPI_Allreduce(void * sendbuf, void * recvbuf, int count, MPI_Datatype datatype, MPI_Op op, MPI_Comm comm)
　　归约所有进程的计算结果，并将最终的结果传递给所有其它的进程，相当于每一个进程都执行了一次MPI_Reduce调用。

int MPI_Alltoall(void * sendbuf, void * recvbuf, int count, MPI_Datatype datatype, void * recvbuf, int * recvcounts, int * rdispls, MPI_Datatype recvtype, MPI_Comm comm)
　　所有进程相互交换数据

int MPI_Alltoallv(void * sendbuf, int * sendcount, int * sdispls, MPI_Datatype sendtype, void * recvbuf, int * recvcounts, int * rdispls, MPI_Datatype recvtype, MPI_Comm comm)
　　所有进程相互交换数据, 但数据有一个偏移量。

Int MPI_Attr_delete(MPI_Comm comm, int keyval)
　　删除与指定关键词联系的属性值。即将废弃的特性，建议用MPI_Comm_delete_attr替代

int MPI_Attr_get(MPI_Comm comm, int keyval, void * attribute_val, int * flag)
　　按关键词查找属性值，即将废弃的特性，建议用MPI_Comm_get_attr替代

int MPI_Attr_put(MPI_Comm comm, int keyval, void * attribute_val)
　　按关键词设置属性值。即将废弃的特性，建议用MPI_Comm_set_attr替代

int MPI_Barrier(MPI_Comm comm)
　　等待直到所有的进程都执行到这一例程才继续执行下一条语句。

int MPI_Bcast(void * buffer, int count, MPI_Datatype datatype, int root, MPI_Comm comm)
　　将root进程的消息广播到所有其它的进程

int MPI_Bsend(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm)
　　使用用户声明的缓冲区进行发送

int MPI_Bsend_init(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request * request)
　　建立发送缓冲句柄

int MPI_Buffer_attach(void * buffer, int size)
　　将一个用户指定的缓冲区用于消息发送的目的

int MPI_Buffer_detach(void * buffer, int * size)
　　移走一个指定的发送缓冲区

int MPI_Cancel(MPI_Request * request)
　　取消一个通信请求

int MPI_Cart_coords(MPI_Comm comm, int rank, int maxdims, int * coords)
　　给出一个进程所在组的标识号，得到其卡氏坐标值

int MPI_Cart_create(MPI_Comm comm_old, int ndims, int * dims, int * periods, int reorder, MPI_Comm * comm_cart )
　　按给定的拓扑创建一个新的通信域

int MPI_Cart_get(MPI_Comm comm, int maxdims, int * dims, int *periods, int * coords)
　　得到给定通信域的卡氏拓扑信息

int MPI_Cart_map(MPI_Comm comm, int * ndims, int * periods, int * newrank)
　　将进程标识号映射为卡氏拓扑坐标

int MPI_Cart_rank(MPI_Comm comm, int * coords, int * rank)
　　由进程标识号得到卡氏坐标

int MPI_Cart_shift(MPI_Comm comm, int direction, int disp, int * rank_source, int * rank_dest)
　　给定进程标识号、平移方向与大小，得到相对于当前进程的源和目的进程的标识号 

int MPI_Cart_sub(MPI_Comm comm, int * remain_dims, MPI_Comm * newcomm)
　　将一个通信域，保留给定的维，得到子通信域

int MPI_Cartdim_get(MPI_Comm comm, int* ndims)
　　得到给定通信域的卡氏拓扑

int MPI_Comm_compare(MPI_comm comm1, MPI_Comm comm2, int * result)
　　两个通信域的比较

int MPI_Comm_create(MPI_Comm comm, MPI_Group group, MPI_Comm * newcomm)
　　根据进程组创建新的通信域

Int MPI_Comm_dup(MPI_Comm comm, MPI_Comm *new_comm)
　　通信域复制

int MPI_Comm_free(MPI_Comm* comm)
　　释放一个通信域对象

int MPI_Comm_group(MPI_Comm comm, MPI_Group * group)
　　由给定的通信域得到组信息

int MPI_Comm_rank(MPI_Comm comm, int * rank)
　　得到调用进程在给定通信域中的进程标识号

int MPI_Comm_remote_group(MPI_Comm comm, MPI_Group * group)
　　得到组间通信域的远程组

int MPI_Comm_remote_size(MPI_Comm comm, int * size)
　　得到远程组的进程数

int MPI_Comm_set_attr(MPI_Comm comm, int keyval, void * attribute_val)
　　根据关键词保存属性值

int MPI_Comm_size(MPI_Comm comm, int * size)
　　得到通信域组的大小

int MPI_Comm_split(MPI_Comm comm, int color, int key, MPI_Comm * newcomm)
　　按照给定的颜色和关键词创建新的通信域

int MPI_Comm_test_inter(MPI_Comm comm, int * flag)
　　测试给定通信域是否是域间域 

int MPI_Dims_create(int nnodes, int ndims, int * dims)
　　在卡氏网格中建立进程维的划分

int MPI_Errhandler_create(MPI_handler_function * function, MPI_Errhandler * errhandler)
　　创建MPI错误句柄。过时特性，建议用MPI_Comm_create_errhandler替代

int MPI_Errhandler_free(MPI_Errhandler * errhandler)
　　释放MPI错误句柄

int MPI_Errhandler_get(MPI_Comm comm, MPI_Errhandler * errhandler)
　　得到给定通信域的错误句柄，即将废弃的特性，建议用MPI_Comm_get_errhandler代替

int MPI_Errhandler_set(MPI_Comm comm, MPI_Errhandler errhandler)
　　设置MPI错误句柄，即将废弃的特性，建议用MPI_Comm_set_errhandler代替

int MPI_Error_class(int errorcode, int * errorclass)
　　将错误代码转换为错误类

int MPI_Error_string(int errorcode, char * string, int * resultlen)
　　由给定的错误代码，返回它所对应的字符串

int MPI_Finalize(void)
　　结束MPI运行环境

int MPI_Gather(void * sendbuf, int sendcount, MPI_Datatype sendtype, void * recvbuf, int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm)
　　从进程组中收集消息
int MPI_Gatherv(void * sendbuf, int sendcount, MPI_Datatype sendtype, void * recvbuf, int * recvcounts, int * displs, MPI_Datatype recvtype, int root, MPI_Comm comm)
　　从进程组中收集消息到指定的位置
int MPI_Get_count(MPI_Status * status, MPI_Datatype datatype, int * count)
　　得到以给定数据类型为单位的数据的个数
int MPI_Get_elements(MPI_Statue * status, MPI_Datatype datatype, int * elements)
　　返回给定数据类型中基本元素的个数
int MPI_Get_processor_name(char * name, int * resultlen)
　　得到处理器名称
int MPI_Get_version(int * version, int * subversion)
　　返回MPI的版本号
int MPI_Graph_create(MPI_Comm comm_old, int nnodes, int * index, int * edges, int reorder, MPI_Comm * comm_graph)
　　按照给定的拓扑创建新的通信域
int MPI_Graph_get(MPI_Comm comm, int maxindex, int maxedges, int * index, int * edges)
　　得到给定通信域的处理器拓扑结构
int MPI_Graph_map(MPI_Comm comm, int nnodes, int * index, int * edges, int * newrank)
　　将进程映射到给定的拓扑
int MPI_Graph_neighbors_count(MPI_Comm comm, int rank, int * nneighbors)
　　给定拓扑，返回给定结点的相邻结点数
int MPI_Graph_neighbors(MPI_Comm comm, int rank, int * maxneighbors, int * neighbors)
　　给定拓扑，返回给定结点的相邻结点
int MPI_Graphdims_Get(MPI_Comm comm, int * nnodes, int * nedges)
　　得到给定通信域的图拓扑
int MPI_Group_compare(MPI_Group group1, MPI_Group group2, int * result)
　　比较两个组
int MPI_Group_diffenence(MPI_Group group1, MPI_Group group2, MPI_Group * newgroup)
　　根据两个组的差异创建一个新组
int MPI_Group_excl(MPI_Group group, int n, int * ranks, MPI_Group * newgroup)
　　通过重新对一个已经存在的组进行排序, 根据未列出的成员创建一个新组
int MPI_Group_free(MPI_Group * group)
　　释放一个组
int MPI_Group_incl(MPI_Group group, int n, int * ranks, MPI_Group * newgroup)
　　通过重新对一个已经存在的组进行排序, 根据列出的成员创建一个新组
int MPI_Group_intersection(MPI_Group group1, MPI_Group group2, MPI_Group * newgroup)
　　根据两个已存在组的交创建一个新组
int MPI_Group_range_excl(MPI_Group group, int n, int ranges[][3], MPI_group * newgroup)
　　根据已存在的组, 去掉指定的部分, 创建一个新组
int MPI_Group_range_incl(MPI_Group group, int n, int ranges[][3], MPI_Group * newgroup)
　　根据已存在的组, 按照指定的部分, 创建一个新组
int MPI_Group_rank(MPI_Group group, int * rank)
　　返回调用进程在给定组中的进程标识号
int MPI_Group_size(MPI_Group group, int * size)
　　返回给定组的大小
int MPI_Group_translate_ranks(MPI_Group group1, int n, int * ranks1, MPI_Group group2, int * ranks2)
　　将一个组中的进程标识号转换成另一个组的进程标识号
int MPI_Group_union(MPI_Group group1, MPI_Group group2, MPI_Group * newgroup)
　　将两个组合并为一个新组

int MPI_Ibsend(void * buf, int count, MPI_Datatype datatype, int dest, int tga, MPI_Comm comm, MPI_Request * request)

　　非阻塞同步发送

int MPI_Keyval_create(MPI_Copy_function * copy_fn, MPI_Delete_function * delete_fn, int * keyval, void * extra_state)
　　创建一个新的属性关键词，即将废弃的特性, 建议用MPI_Comm_create_keyval代替

int MPI_Keyval_free(int * keyval)
　　释放一个属性关键词

int MPI_Op_create(MPI_Uop function, int commute, MPI_Op * op)
　　创建一个用户定义的通信函数句柄

int MPI_Op_free(MPI_Op * op)
　　释放一个用户定义的通信函数句柄

int MPI_Pack(void * inbuf, int incount, MPI_Datatype datetype, void * outbuf, int outcount, int * position, MPI_Comm comm)
　　将数据打包, 放到一个连续的缓冲区中

int MPI_Pack_size(int incount, MPI_Datatype datatype, MPI_Comm comm, int * size)
　　返回需要打包的数据类型的大小

int MPI_Pcontrol(const int level)
　　控制剖视

int MPI_Probe(int source, int tag, MPI_Comm comm, MPI_Status * status)
　　阻塞消息测试

int MPI_Recv(void * buf, int count, MPI_Datatype datatype, int source, int tag, MPI_Comm comm, MPI_Status * status)
　　标准接收

int MPI_Recv_init(void * buf, int count, MPI_Datatype datatype, int source, int tag, MPI_Comm comm, MPI_Request * request)
　　创建接收句柄

int MPI_Reduce(void * sendbuf, void * recvbuf, int count, MPI_Datatype datatype, MPI_Op op, int root, MPI_Comm comm)
　　将所进程的值归约到root进程, 得到一个结果

int MPI_Reduce_scatter(void * sendbuf, void * recvbuf, int * recvcounts, MPI_Datatype datatype, MPI_Op op, MPI_Comm comm)
　　将结果归约后再发送出去

int MPI_Request_free(MPI_Request * request)
　　释放通信申请对象

int MPI_Rsend(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm)
　　就绪发送

int MPI_Rsend_init(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request * request)
　　创建就绪发送句柄

int MPI_Scan(void * sendbuf, void * recvbuf, int count, MPI_Datatype datatype, MPI_Op op, MPI_Comm comm)
　　在给定的进程集合上进行扫描操作

int MPI_Scatter(void * sendbuf, int sendcount, MPI_Datatype sendtype, void * recvbuf, int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm)
　　将数据从一个进程发送到组中其它进程

int MPI_Scatterv(void * sendbuf, int * sendcounts, int * displs, MPI_Datatype sendtype, void * recvbuf, int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm)
　　将缓冲区中指定部分的数据从一个进程发送到组中其它进程 

int MPI_Send(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm)
　　标准的数据发送

int MPI_Send_init(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request * request)
　　创建一个标准发送的句柄

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)
　　同时完成发送和接收操作

int MPI_Sendrecv_replace(void * buf, int count, MPI_Datatype datatype, int dest, int sendtag, int source, int recvtag, MPI_Comm comm, MPI_Status * status)
　　用同一个发送和接收缓冲区进行发送和接收操作

int MPI_Ssend(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm)
　　同步发送

int MPI_Ssend_init(void * buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request * request)
　　创建一个同步发送句柄

int MPI_Start(MPI_Request * request)
　　启动给定对象上的重复通信请求

int MPI_Startall(int count, MPI_Request * array_of_requests)
　　启动指定的所有重复通信请求

int MPI_Test(MPI_Request * request, int * flag, MPI_Status * status)
　　测试发送或接收是否完成

int MPI_Testall(int count, MPI_Request * array_of_requests, int * flag, MPI_Status * array_of_statuses)
　　测试前面所有的通信是否完成

int MPI_Testany(int count, MPI_Request * array_of_requests, int * index, int * flag, MPI_Status * status)
　　测试前面任何一个通信是否完成

int MPI_Testsome(int incount, MPI_Request * array_of_requests, int * outcount, int * array_of_indices, MPI_Status * array_of_statuses)
　　测试是否有一些通信已经完成

int MPI_Test_cancelled(MPI_Status * status, int * flag)
　　测试一个请求对象是否已经删除

int MPI_Topo_test(MPI_Comm comm, int * top_type)
　　测试指定通信域的拓扑类型

int MPI_Type_commit(MPI_Datatype * datatype)
　　提交一个类型

int MPI_Type_contiguous(int count, MPI_Datatype oldtype, MPI_Datatype * newtype)
　　创建一个连续的数据类型

int MPI_Type_extent(MPI_Datatype datatype, MPI_Aint * extent)
　　返回一个数据类型的范围，即将废弃的特性, 建议使用MPI_type_get_extent来代替

int MPI_Type_free(MPI_Datatype * datatype)
　　释放一个数据类型

int MPI_Type_hindexed(int count, int * array_of_blocklengths, MPI_Aint * array_of_displacements, MPI_Datatype oldtype, MPI_Datatype * newtype)
　　按照字节偏移, 创建一个数据类型索引，即将废弃的特性, 建议使用MPI_type_create_hindexed来代替

int MPI_Type_hvector(int count, int blocklength, MPI_Aint stride, MPI_Datatype oldtype, MPI_Datatype * newtype)
　　根据以字节为单位的偏移量, 创建一个向量数据类型，即将废弃的特性, 建议使用MPI_type_create_hvector来代替

int MPI_Type_indexed(int cont, int * array_of_blocklengths, int * array_of_displacements, MPI_Datatype oldtype, MPI_Datatype * newtype)
　　创建一个索引数据类型

int MPI_Type_lb(MPI_Datatype datatype, MPI_Aint * displacement)
　　返回指定数据类型的下边界，即将废弃的特性, 建议使用MPI_type_get_extent来代替

int MPI_Type_size(MPI_Datatype datatype, int * size)
　　以字节为单位, 返回给定数据类型的大小

int MPI_Type_struct(int count, int * array_of_blocklengths, MPI_Aint * array_of_displacements, MPI_Datatype * array_of_types, MPI_Datatype * newtype)
　　创建一个结构数据类型，即将废弃的特性, 建议使用MPI_type_create_struct来代替

int MPI_Type_ub(MPI_Datatype datatype, MPI_Aint * displacement)
　　返回指定数据类型的上边界，即将废弃的特性, 建议使用MPI_type_get_extent来代替

int MPI_Type_vector(int count, int blocklength, int stride, MPI_Datatype oldtype, MPI_Datatype * newtype)
　　创建一个向量数据类型