MPI Subroutine Reference

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