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