MPI Subroutine Reference

MPI_COMM_REMOTE_GROUP, MPI_Comm_remote_group

Purpose

Returns the handle of the remote group of an intercommunicator.

C synopsis

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

C++ synopsis

#include mpi.h
MPI::Group MPI::Intercomm::Get_remote_group() const;

FORTRAN synopsis

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

Parameters

comm

is the intercommunicator (handle) (IN)

group

is the remote group corresponding to comm. (OUT)

IERROR

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

Description

This subroutine is a local operation that returns the handle of the remote group of an intercommunicator.

Notes

To determine the local group of an intercommunicator, use MPI_COMM_GROUP.

Errors

Invalid communicator

Invalid communicator type

it must be intercommunicator

MPI not initialized

MPI already finalized

Related information

MPI_COMM_GROUP