## 4.13.3. Error Handlers for Files

Up: Error Handlers Next: New Datatype Manipulation Functions Previous: Error Handlers for Windows

MPI_FILE_CREATE_ERRHANDLER(function, errhandler)
IN function | user defined error handling procedure (function)
OUT errhandler | MPI error handler (handle)

`int MPI_File_create_errhandler(MPI_File_errhandler_fn *function, MPI_Errhandler *errhandler)
`

`MPI_FILE_CREATE_ERRHANDLER(FUNCTION, ERRHANDLER, IERROR)
EXTERNAL FUNCTION
INTEGER ERRHANDLER, IERROR
`

`static MPI::Errhandler MPI::File::Create_errhandler(MPI::File::Errhandler_fn* function)
`

The user routine should be, in C, a function of type MPI_File_errhandler_fn, which is defined as

`typedef void MPI_File_errhandler_fn(MPI_File *, int *, ...);
`

The first argument is the file in use, the second is the error code to be returned.

In Fortran, the user routine should be of the form:

`SUBROUTINE FILE_ERRHANDLER_FN(FILE, ERROR_CODE, ... )
INTEGER FILE, ERROR_CODE
`

In C++, the user routine should be of the form:

`typedef void MPI::File::Errhandler_fn(MPI::File &, int *, ... );
`

MPI_FILE_SET_ERRHANDLER(file, errhandler)
INOUT file | file (handle)
IN errhandler | new error handler for file (handle)

`int MPI_File_set_errhandler(MPI_File file, MPI_Errhandler errhandler)
`

`MPI_FILE_SET_ERRHANDLER(FILE, ERRHANDLER, IERROR)
INTEGER FILE, ERRHANDLER, IERROR
`

`void MPI::File::Set_errhandler(const MPI::Errhandler& errhandler)
`

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)

`int MPI_File_get_errhandler(MPI_File file, MPI_Errhandler *errhandler)
`

`MPI_FILE_GET_ERRHANDLER(FILE, ERRHANDLER, IERROR)
INTEGER FILE, ERRHANDLER, IERROR
`

`MPI::Errhandler MPI::File::Get_errhandler() const
`

Retrieves the error handler currently associated with a file.

Up: Error Handlers Next: New Datatype Manipulation Functions Previous: Error Handlers for Windows

Return to MPI-2 Standard Index
Return to MPI 1.1 Standard Index
Return to MPI Forum Home Page

MPI-2.0 of July 18, 1997
HTML Generated on September 10, 2001