petsc-3.11.4 2019-09-28

SETERRMPI

Macro to be called when an error has been detected within an MPI callback function

Synopsis

#include <petscsys.h>
PetscErrorCode SETERRMPI(MPI_Comm comm,PetscErrorCode ierr,char *message)

Collective on MPI_Comm

Input Parameters

	comm	- A communicator, use PETSC_COMM_SELF unless you know all ranks of another communicator will detect the error
	ierr	- nonzero error code, see the list of standard error codes in include/petscerror.h
	message	- error message

Notes

This macro is FOR USE IN MPI CALLBACK FUNCTIONS ONLY, such as those passed to MPI_Comm_create_keyval(). It always returns the error code PETSC_MPI_ERROR_CODE which is registered with MPI_Add_error_code() when PETSc is initialized.

Level

developer

Location