MPI_COMM_GROUP, MPI_Comm_group

Purpose

Returns the group handle associated with a communicator.

C synopsis

#include <mpi.h>
int MPI_Comm_group(MPI_Comm comm,MPI_Group *group);

C++ synopsis

#include mpi.h
MPI::Group MPI::Comm::Get_group() const;

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_COMM_GROUP(INTEGER COMM,INTEGER GROUP,INTEGER IERROR)

Parameters

comm
     is the communicator (handle) (IN)

group
     is the group corresponding to comm (handle) (OUT)

IERROR
     is the FORTRAN return code. It is always the last argument.

Description

This subroutine returns the group handle associated with a communicator.

Notes

If comm is an intercommunicator, group is set to the local group.
To determine the remote group of an intercommunicator, use
MPI_COMM_REMOTE_GROUP.

Errors

Invalid communicator

MPI not initialized

MPI already finalized

Related information

     MPI_COMM_REMOTE_GROUP