MPI_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.
NOTES
The MPI standard states that an implementation can make
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 ALSO
MPI_Errhandler_free(3)
Man(1) output converted with
man2html