MPI_TOPO_TEST, MPI_Topo_test

Purpose

Returns the type of virtual topology associated with a communicator.

C synopsis

#include <mpi.h>
MPI_Topo_test(MPI_Comm comm,int *status);

C++ synopsis

#include mpi.h
int MPI::Comm::Get_topology() const;

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_TOPO_TEST(INTEGER COMM,INTEGER STATUS,INTEGER IERROR)

Parameters

comm
     is the communicator (handle) (IN)

status
     is the topology type of communicator comm (integer) (OUT)

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

Description

This subroutine returns the type of virtual topology associated with a
communicator. The output of status will be as follows:

MPI_GRAPH
     graph topology

MPI_CART
     cartesian topology

MPI_UNDEFINED
     no topology

Errors

MPI not initialized

MPI already finalized

Invalid communicator

Related information

     MPI_CART_CREATE