Page tree
Skip to end of metadata
Go to start of metadata

Padb (Parallel Application Debugger) is a Job Inspection Tool for examining and debugging parallel programs, primarily it simplifies the process of gathering stack traces on compute clusters however it also supports a wide range of other functions. Padb supports a number of parallel environments and it works out-of-the-box on the majority of clusters. It’s an open source, non-interactive, command line, script-able tool intended for use by programmers and system administrators alike.   

Current latest version is padb/3.3. Type the following to load it:

module load padb/3.3

Usage

Common Usage

Show current active jobs under PBS:

padb --show-jobs

Target a specific jobid, and reports is process state:

padb <jobid> --proc-summary

Target a specific jobid, and report its MPI message queue, stack traceback, etc.

padb --full-report=<jobid>

Stack Trace

Target a specific jobid, and report its stack trace for a given MPI process (rank):

padb <jobid> --stack-trace --tree --rank <MPI rank id>

Target a specific jobid, and report its stack trace including information about parameters and local variables for a given MPI process (rank):

padb <jobid> --stack-trace --tree --rank <MPI rank id> -O stack-shows-locals=1 -O stack-shows-params=1

MPI Message Queue

Target a specific jobid, and reports its MPI message queues:

padb <jobid> --mpi-queue

Process Progress Watch

Target a specific jobid, and report its MPI process progress over a period of time:

padb <jobid> --mpi-watch --watch -O watch-clears-screen=no

For more detailed usage please refer to PADB’s “Mode of operation” web page, http://padb.pittman.org.uk/modes.html, or PADB’s help information:

padb -h