Error codes and classes

Up: MPI Environmental Management Next: Timers Previous: Error handling

The error codes returned by MPI are left entirely to the implementation (with the exception of MPI_SUCCESS). This is done to allow an implementation to provide as much information as possible in the error code (for use with MPI_ERROR_STRING).

To make it possible for an application to interpret an error code, the routine MPI_ERROR_CLASS converts an error code into one of a small set of specified values, called error classes. Valid error classes include

An implementation is free to define more error classes; however, the standard error classes must be used where appropriate. The error classes satisfy,

[] Rationale.

The difference between MPI_ERR_UNKNOWN and MPI_ERR_OTHER is that MPI_ERROR_STRING can return useful information about MPI_ERR_OTHER.

Note that MPI_SUCCESS= 0 is necessary to be consistent with C practice; the separation of error classes and error codes allows us to define the error classes this way. Having a known LASTCODE is often a nice sanity check as well. ( End of rationale.)
MPI_ERROR_CLASS( errorcode, errorclass )
[ IN errorcode] Error code returned by an MPI routine
[ OUT errorclass] Error class associated with errorcode

int MPI_Error_class(int errorcode, int *errorclass)


Up: MPI Environmental Management Next: Timers Previous: Error handling

Return to MPI Standard Index
Return to MPI home page