What is MPI_Win_get_group?

MPI library

MPI, short for Message Passing Interface, is a library that allows you to write parallel programs in Fortran77 or C. The library uses common operating system services to exchange information among the parallel processes it creates.

MPI_Win_get_group

This method returns a duplicate of the group of the communicator used to create a window object.

Syntax

int MPI_Win_get_group(MPI_Win win, MPI_Group * group)

Parameters

• win is the window object used by processes to perform RMA (Remote Memory Access) operations. RMA (Remote Memory Access) is direct memory access from one process to another process in heterogenous Operating Systems (OS).

• group is an output parameter representing a group of processes that share access to the window.

Return value

• If unsuccessful, the function returns an error. The error, by default, aborts the MPI job.

• In case of success, it returns MPI_SUCCESS, which is the value returned upon successful termination of any MPI routine.

• In case an invalid window object is provided in the function’s argument, MPI_ERR_WIN is returned.

• MPI_ARR_ARG is returned if an invalid argument is used and the error class does not identify that.

• MPI_ERR_OTHER is returned there are any other errors. MPI_Error_string can be used to get more information about this error code.