MPI_Errhandler_create(3)

NAME
     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 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 ALSO
     MPI_Errhandler_free(3)