MPI Subroutine Reference

MPI_COMM_GET_ERRHANDLER, MPI_Comm_get_errhandler

Purpose

Retrieves the error handler currently associated with a communicator.

C synopsis

#include <mpi.h>
int MPI_Comm_get_errhandler (MPI_Comm comm, MPI_Errhandler *errhandler);

C++ synopsis

#include mpi.h
MPI::Errhandler MPI::Comm::Get_errhandler() const;

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_COMM_GET_ERRHANDLER(INTEGER COMM, INTEGER ERRHANDLER, INTEGER IERROR)

Parameters

comm

is the communicator (handle) (IN)

errhandler

is the error handler that is currently associated with the communicator (handle) (OUT)

IERROR

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

Description

This subroutine returns the error handler errhandler currently associated with communicator comm.

Notes

MPI_COMM_GET_ERRHANDLER supersedes MPI_ERRHANDLER_GET.

Errors

Fatal errors:

Invalid communicator

MPI not initialized

MPI already finalized

Related information

MPI_COMM_CALL_ERRHANDLER

MPI_COMM_CREATE_ERRHANDLER

MPI_COMM_SET_ERRHANDLER

MPI_ERRHANDLER_FREE