Topology Inquiry Functions



next up previous contents
Next: An Application Example Up: Process Topologies Previous: Low-level Graph Functions

Topology Inquiry Functions

A routine may receive a communicator for which it is unknown what type of topology is associated with it. MPI_TOPO_TEST allows one to answer this question. This is a local call.

 MPI_TOPO_TEST(comm, status)

  IN    comm         communicator
  OUT  status        topology type of comunicator comm 
MPI_Topo_test(MPI_Comm comm, int *status)

MPI_TOPO_TEST(COMM, STATUS, IERROR)INTEGER COMM, STATUS, IERROR

The function MPI_TOPO_TEST returns the type of topology that is assigned to a communicator.

The output value status is one of the following:

 MPI_GRAPH              graph topology
 MPI_CART               Cartesian topology
 MPI_UNDEFINED          no topology


Jack Dongarra
Fri Sep 1 06:16:55 EDT 1995