pstack

PSTACK(1)                  Linux Programmer’s Manual                 PSTACK(1)

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 com-
       mand line, and prints out an execution stack trace, including a hint at
       what  the function arguments are.  If symbols exist in the binary (usu-
       ally 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 informa-
       tion, 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>



Red Hat Linux                     Feb 25 2002                        PSTACK(1)