NAME

       pstack - print a stack trace of running processes

SYNOPSIS

       pstack pid [...]

DESCRIPTION

       pstack  attaches to the active processes named by the pids on the command line, and prints
       out an execution stack trace, including a hint at what the  function  arguments  are.   If
       symbols exist in the binary (usually the case unless you have run strip(1)), then symbolic
       addresses are printed as well.

       If the process is part of a thread group, then pstack will print out  a  stack  trace  for
       each of the threads in the group.

RESTRICTIONS

       pstack  currently  works only on Linux, only on an x86 machine running 32 bit ELF binaries
       (64 bit not supported).  Also, for symbolic information, you need to use a GNU compiler to
       generate  your  program,  and  you  can't  strip  symbols  from  the binaries.  For thread
       information to be dumped, you have to use the  debug-aware  version  of  the  LinuxThreads
       libpthread.so  library.  (To check, run nm(1) on your pthreads library, and make sure that
       the symbol "__pthread_threads_debug" is defined.)  Threads  are  not  supported  with  the
       newer NPTL libpthread.so library.

SEE ALSO

       nm(1), ptrace(2)

AUTHORS

       Ross Thompson <ross@whatsis.com>

       Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla>