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