PetscAttachDebugger — PETSc 3.25.0 documentation

Skip to main content
`Ctrl`+`K`

# PetscAttachDebugger

Attaches the debugger to the running process.

## Synopsis

    #include "petscsys.h"
    PetscErrorCode PetscAttachDebugger(void)

Not Collective

## Options Database Keys

- -start_in_debugger [(noxterm)],[(lldb|gdb|…)] - Set debugger debug_terminal xterm or Terminal (for Apple)

- -display name - XDisplay to open xterm in

- -debugger_ranks m,n - Which MPI ranks on which to start the debugger, defaults to all

- -stop_for_debugger - Print a message on how to attach the process with a debugger and then wait for the user to attach

- -debugger_pause secs - Wait secs before attaching the debugger. This is useful for slow connections that take a long time for the Terminal window or xterm to start up.

## Note

If you get the message “`stdin` is not a `tty`, hence unable to attach debugger, see `PetscAttachDebugger()`”, this means the application is likely running in a batch system and you do not have terminal access to the process. You can try running with `-start_in_debugger` without the `noxterm` argument or `-stop_for_debugger`

## Developer Note

Since this can be called by the error handler, should it be calling `SETERRQ()` and `PetscCall()`?

## See Also

`PetscSetDebugger()`, `PetscSetDefaultDebugger()`, `PetscSetDebugTerminal()`, `PetscAttachDebuggerErrorHandler()`, `PetscStopForDebugger()`

## Level

advanced

## Location

src/sys/error/adebug.c

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