xref: /petsc/src/sys/error/errstop.c (revision 3ba1676111f5c958fe6c2729b46ca4d523958bb3)
1e5c89e4eSSatish Balay 
2c6db04a5SJed Brown #include <petscsys.h> /*I "petscsys.h" I*/
3e5c89e4eSSatish Balay 
4e5c89e4eSSatish Balay /*@C
541e02c4dSJunchao Zhang    PetscMPIAbortErrorHandler - Calls PETSCABORT and exits.
6e5c89e4eSSatish Balay 
7e5c89e4eSSatish Balay    Not Collective
8e5c89e4eSSatish Balay 
9e5c89e4eSSatish Balay    Input Parameters:
10e32f2f54SBarry Smith +  comm - communicator over which error occurred
11e32f2f54SBarry Smith .  line - the line number of the error (indicated by __LINE__)
12e5c89e4eSSatish Balay .  file - the file in which the error was detected (indicated by __FILE__)
13e5c89e4eSSatish Balay .  mess - an error text string, usually just printed to the screen
14e5c89e4eSSatish Balay .  n - the generic error number
15811af0c4SBarry Smith .  p - `PETSC_ERROR_INITIAL` if error just detected, otherwise `PETSC_ERROR_REPEAT`
16e5c89e4eSSatish Balay -  ctx - error handler context
17e5c89e4eSSatish Balay 
18e5c89e4eSSatish Balay    Level: developer
19e5c89e4eSSatish Balay 
20811af0c4SBarry Smith    Note:
21811af0c4SBarry Smith    Users do not directly call this routine
22e5c89e4eSSatish Balay 
23811af0c4SBarry Smith    Use `PetscPushErrorHandler()` to set the desired error handler.  The
24811af0c4SBarry Smith    currently available PETSc error handlers include `PetscTraceBackErrorHandler()`,
25811af0c4SBarry Smith    `PetscMPIAbortErrorHandler()`, `PetscAttachDebuggerErrorHandler()`, and `PetscAbortErrorHandler()`.
26e5c89e4eSSatish Balay 
27db781477SPatrick Sanan .seealso: `PetscError()`, `PetscPushErrorHandler()`, `PetscPopErrorHandler()`, `PetscAttachDebuggerErrorHandler()`,
28db781477SPatrick Sanan           `PetscAbortErrorHandler()`, `PetscMPIAbortErrorHandler()`, `PetscTraceBackErrorHandler()`, `PetscEmacsClientErrorHandler()`, `PetscReturnErrorHandler()`
29e5c89e4eSSatish Balay  @*/
30d71ae5a4SJacob Faibussowitsch PetscErrorCode PetscMPIAbortErrorHandler(MPI_Comm comm, int line, const char *fun, const char *file, PetscErrorCode n, PetscErrorType p, const char *mess, void *ctx)
31d71ae5a4SJacob Faibussowitsch {
32*3ba16761SJacob Faibussowitsch   PetscErrorCode ierr;
33574034a9SJed Brown   PetscBool      flg1 = PETSC_FALSE, flg2 = PETSC_FALSE, flg3 = PETSC_FALSE;
34e5c89e4eSSatish Balay   PetscLogDouble mem, rss;
35e5c89e4eSSatish Balay 
36e5c89e4eSSatish Balay   PetscFunctionBegin;
37e5c89e4eSSatish Balay   if (!mess) mess = " ";
38e5c89e4eSSatish Balay 
39e5c89e4eSSatish Balay   if (n == PETSC_ERR_MEM) {
40*3ba16761SJacob Faibussowitsch     ierr = (*PetscErrorPrintf)("%s() at %s:%d\n", fun, file, line);
41*3ba16761SJacob Faibussowitsch     ierr = (*PetscErrorPrintf)("Out of memory. This could be due to allocating\n");
42*3ba16761SJacob Faibussowitsch     ierr = (*PetscErrorPrintf)("too large an object or bleeding by not properly\n");
43*3ba16761SJacob Faibussowitsch     ierr = (*PetscErrorPrintf)("destroying unneeded objects.\n");
44*3ba16761SJacob Faibussowitsch     ierr = PetscMallocGetCurrentUsage(&mem);
45*3ba16761SJacob Faibussowitsch     ierr = PetscMemoryGetCurrentUsage(&rss);
46*3ba16761SJacob Faibussowitsch     ierr = PetscOptionsGetBool(NULL, NULL, "-malloc_dump", &flg1, NULL);
47*3ba16761SJacob Faibussowitsch     ierr = PetscOptionsGetBool(NULL, NULL, "-malloc_view", &flg2, NULL);
48*3ba16761SJacob Faibussowitsch     ierr = PetscOptionsHasName(NULL, NULL, "-malloc_view_threshold", &flg3);
49*3ba16761SJacob Faibussowitsch     if (flg2 || flg3) ierr = PetscMallocView(stdout);
50a297a907SKarl Rupp     else {
51*3ba16761SJacob Faibussowitsch       ierr = (*PetscErrorPrintf)("Memory allocated %.0f Memory used by process %.0f\n", mem, rss);
52*3ba16761SJacob Faibussowitsch       if (flg1) ierr = PetscMallocDump(stdout);
53*3ba16761SJacob Faibussowitsch       else ierr = (*PetscErrorPrintf)("Try running with -malloc_dump or -malloc_view for info.\n");
54e5c89e4eSSatish Balay     }
55e5c89e4eSSatish Balay   } else if (n == PETSC_ERR_SUP) {
56*3ba16761SJacob Faibussowitsch     ierr = (*PetscErrorPrintf)("%s() at %s:%d\n", fun, file, line);
57*3ba16761SJacob Faibussowitsch     ierr = (*PetscErrorPrintf)("No support for this operation for this object type!\n");
58*3ba16761SJacob Faibussowitsch     ierr = (*PetscErrorPrintf)("%s\n", mess);
59*3ba16761SJacob Faibussowitsch   } else if (n == PETSC_ERR_SIG) ierr = (*PetscErrorPrintf)("%s() at %s:%d %s\n", fun, file, line, mess);
60*3ba16761SJacob Faibussowitsch   else ierr = (*PetscErrorPrintf)("%s() at %s:%d\n    %s\n", fun, file, line, mess);
61a297a907SKarl Rupp 
62*3ba16761SJacob Faibussowitsch   (void)ierr;
6341e02c4dSJunchao Zhang   PETSCABORT(PETSC_COMM_WORLD, n);
64*3ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
65e5c89e4eSSatish Balay }
66