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 or 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
- Waitbefore 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#
Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages