mpi_topo_test(3openmpi) [osx man page]
MPI_Topo_test(3OpenMPI) MPI_Topo_test(3OpenMPI) NAME
MPI_Topo_test - Determines the type of topology (if any) associated with a communicator. SYNTAX
C Syntax #include <mpi.h> int MPI_Topo_test(MPI_Comm comm, int *top_type) Fortran Syntax INCLUDE 'mpif.h' MPI_TOPO_TEST(COMM, TOP_TYPE, IERROR) INTEGER COMM, TOP_TYPE, IERROR C++ Syntax #include <mpi.h> int Comm::Get_topology() const INPUT PARAMETER
comm Communicator (handle). OUTPUT PARAMETERS
top_type Topology type of communicator comm (choice). IERROR Fortran only: Error status (integer). DESCRIPTION
The function MPI_Topo_test returns the type of topology that is assigned to a communicator. The output value top_type is one of the following: MPI_GRAPH graph topology MPI_CART Cartesian topology MPI_UNDEFINED no topology ERRORS
Almost all MPI routines return an error value; C routines as the value of the function and Fortran routines in the last argument. C++ func- tions do not return errors. If the default error handler is set to MPI::ERRORS_THROW_EXCEPTIONS, then on error the C++ exception mechanism will be used to throw an MPI:Exception object. Before the error value is returned, the current MPI error handler is called. By default, this error handler aborts the MPI job, except for I/O function errors. The error handler may be changed with MPI_Comm_set_errhandler; the predefined error handler MPI_ERRORS_RETURN may be used to cause error values to be returned. Note that MPI does not guarantee that an MPI program can continue past an error. SEE ALSO
MPI_Graph_create MPI_Cart_create Open MPI 1.2 September 2006 MPI_Topo_test(3OpenMPI)
Check Out this Related Man Page
MPI_Errhandler_get(3OpenMPI) MPI_Errhandler_get(3OpenMPI) NAME
MPI_Errhandler_get - Gets the error handler for a communicator -- use of this routine is deprecated. SYNTAX
C Syntax #include <mpi.h> int MPI_Errhandler_get(MPI_Comm comm, MPI_Errhandler *errhandler) Fortran Syntax INCLUDE 'mpif.h' MPI_ERRHANDLER_GET(COMM, ERRHANDLER, IERROR) INTEGER COMM, ERRHANDLER, IERROR INPUT PARAMETER
comm Communicator to get the error handler from (handle). OUTPUT PARAMETERS
errhandler MPI error handler currently associated with communicator (handle). IERROR Fortran only: Error status (integer). DESCRIPTION
Note that use of this routine is deprecated as of MPI-2. Please use MPI_Comm_get_errhandler instead. This deprecated routine is not available in C++. Returns in errhandler (a handle to) the error handler that is currently associated with communicator comm. Example: A library function may register at its entry point the current error handler for a communicator, set its own private error handler for this communicator, and restore before exiting the previous error handler. ERRORS
Almost all MPI routines return an error value; C routines as the value of the function and Fortran routines in the last argument. C++ func- tions do not return errors. If the default error handler is set to MPI::ERRORS_THROW_EXCEPTIONS, then on error the C++ exception mechanism will be used to throw an MPI:Exception object. Before the error value is returned, the current MPI error handler is called. By default, this error handler aborts the MPI job, except for I/O function errors. The error handler may be changed with MPI_Comm_set_errhandler; the predefined error handler MPI_ERRORS_RETURN may be used to cause error values to be returned. Note that MPI does not guarantee that an MPI program can continue past an error. SEE ALSO
MPI_Comm_create_errhandler MPI_Comm_get_errhandler MPI_Comm_set_errhandler Open MPI 1.2 September 2006 MPI_Errhandler_get(3OpenMPI)