MPI_ERRHANDLER_CREATE(3)MPI_ERRHANDLER_CREATE(3)NAMEMPI_Errhandler_create - Creates an MPI-style error handler
SYNOPSIS
C:
#include <mpi.h>
int MPI_Errhandler_create( function, errhandler )
MPI_Handler_function *function;
MPI_Errhandler *errhandler;
C++:
#include <mpi.h>
Errhandler Comm::Create_errhandler(
Comm::Errhandler_fn*function)
Fortran:
INCLUDE "mpif.h" (or USE MPI)
INTEGER errhandler, ierror
EXTERNAL function
CALL MPI_ERRHANDLER_CREATE(function, errhandler,
ierror)
STANDARDS
This release implements the MPI 1.2 standard, as documented by the MPI
Forum in the spring 1997 release of MPI: A Message Passing Interface
Standard.
DESCRIPTION
The MPI_Errhandler_create routine creates an MPI-style error handler.
This routine accepts the following parameters:
function Specifies a user-defined error handling procedure
errhandler Returns an MPI error handler (handle)
ierror Specifies the return code value for successful completion,
which is in MPI_SUCCESS. MPI_SUCCESS is defined in the
mpif.h file.
Page 1
MPI_ERRHANDLER_CREATE(3)MPI_ERRHANDLER_CREATE(3)NOTES
The MPI standard states that an implementation can make the output value
(errhandler) simply the address of the function. However, the action of
the MPI_Errhandler_free(3) routine makes this impossible, because it is
required that the value of the argument be set to MPI_ERRHANDLER_NULL.
In addition, the actual error handler must remain until all communicators
that use it are freed.
SEE ALSOMPI_Errhandler_free(3)
Page 2