MPI_FILE_CREATE_ERRHANDLER(file_errhandler_fn, errhandler) | |
IN file_errhandler_fn | user defined error handling procedure (function) |
OUT errhandler | MPI error handler (handle) |
Creates an error handler that can be attached to a file object. The user routine should be, in C, a function of type MPI_File_errhandler_function, which is defined as
typedef void MPI_File_errhandler_function(MPI_File *file, int *error_code, ...);
The first argument is the file in use, the second is the error code to be returned. The remaining arguments are ``varargs'' arguments whose number and meaning is implementation-dependent. An implementation should clearly document these arguments.
With the Fortran mpi_f08 module, the user routine file_errhandler_fn should be of the form:
ABSTRACT INTERFACE
SUBROUTINE MPI_File_errhandler_function(file, error_code)
TYPE(MPI_File) :: file
INTEGER :: error_code
With the Fortran mpi module and (deprecated) mpif.h include file, the user routine FILE_ERRHANDLER_FN should be of the form:
SUBROUTINE FILE_ERRHANDLER_FUNCTION(FILE, ERROR_CODE)
INTEGER FILE, ERROR_CODE
MPI_FILE_SET_ERRHANDLER(file, errhandler) | |
INOUT file | file (handle) |
IN errhandler | new error handler for file (handle) |
Attaches a new error handler to a file. The error handler must be either a predefined error handler, or an error handler created by a call to MPI_FILE_CREATE_ERRHANDLER.
MPI_FILE_GET_ERRHANDLER(file, errhandler) | |
IN file | file (handle) |
OUT errhandler | error handler currently associated with file (handle) |
Retrieves the error handler currently associated with a file.