PetscStackView — PETSc 3.25.4 documentation

Skip to main content
`Ctrl`+`K`

# PetscStackView

Print the current (default) PETSc stack to an ASCII file

## Synopsis

    #include "petscsys.h"
    PetscErrorCode PetscStackView(FILE *file)

Not Collective, No Fortran Support

## Input Parameter

- file - the file pointer, or `NULL` to use `PETSC_STDERR`

## Notes

In debug mode PETSc maintains a stack of the current function calls that can be used to help to quickly see where a problem has occurred, for example, when a signal is received. It is recommended to use the debugger if extensive information is needed to help debug the problem.

If `file` is `PETSC_STDERR` (or `NULL`) then `PetscErrorPrintf()` is used to print the stack, otherwise `fprintf()` is used.

The stack is maintained only when PETSc is configured `--with-debugging` and without thread safety; in other configurations this becomes a no-op that returns `PETSC_SUCCESS`.

## Developer Note

The default stack is a global variable called `petscstack`.

## See Also

`PetscAttachDebugger()`, `PetscStackCopy()`, `PetscStackPrint()`, `PetscStackSAWsGrantAccess()`, `PetscStackSAWsTakeAccess()`

## Level

developer

## Location

src/sys/error/pstack.c

Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages