:orphan: # PetscTraceBackErrorHandler Default error handler routine that generates a traceback on error detection. ## Synopsis ``` #include "petscsys.h" PetscErrorCode PetscTraceBackErrorHandler(MPI_Comm comm, int line, const char *fun, const char *file, PetscErrorCode n, PetscErrorType p, const char *mess, void *ctx) ``` Not Collective ## Input Parameters - ***comm -*** communicator over which error occurred - ***line -*** the line number of the error (indicated by __LINE__) - ***file -*** the file in which the error was detected (indicated by __FILE__) - ***mess -*** an error text string, usually just printed to the screen - ***n -*** the generic error number - ***p -*** `PETSC_ERROR_INITIAL` if this is the first call the error handler, otherwise `PETSC_ERROR_REPEAT` - ***ctx -*** error handler context ## Options Database Keys - ***-error_output_stdout -*** output the error messages to stdout instead of the default stderr - ***-error_output_none -*** do not output the error messages ## Notes Users do not directly call this routine Use `PetscPushErrorHandler()` to set the desired error handler. ## See Also `PetscError()`, `PetscPushErrorHandler()`, `PetscPopErrorHandler()`, `PetscAttachDebuggerErrorHandler()`, `PetscAbortErrorHandler()`, `PetscMPIAbortErrorHandler()`, `PetscReturnErrorHandler()`, `PetscEmacsClientErrorHandler()` ## Level developer ## Location src/sys/error/errtrace.c --- [Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/sys/error/errtrace.c) [Index of all Sys routines](index.md) [Table of Contents for all manual pages](/manualpages/index.md) [Index of all manual pages](/manualpages/singleindex.md)