gstack.1 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. .\"
  2. .\" gstack manual page.
  3. .\" Copyright (c) 1999 Ross Thompson
  4. .\" Copyright (c) 2001, 2002, 2004, 2008 Red Hat, Inc.
  5. .\"
  6. .\" Original author: Ross Thompson <ross@whatsis.com>
  7. .\"
  8. .\" This program is free software; you can redistribute it and/or modify
  9. .\" it under the terms of the GNU General Public License as published by
  10. .\" the Free Software Foundation; either version 2, or (at your option)
  11. .\" any later version.
  12. .\"
  13. .\" This program is distributed in the hope that it will be useful,
  14. .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. .\" GNU General Public License for more details.
  17. .\"
  18. .\" You should have received a copy of the GNU General Public License
  19. .\" along with this program; see the file COPYING. If not, write to
  20. .\" the Free Software Foundation, 59 Temple Place - Suite 330,
  21. .\" Boston, MA 02111-1307, USA.
  22. .\"
  23. .TH GSTACK 1 "Feb 15 2008" "Red Hat Linux" "Linux Programmer's Manual"
  24. .SH NAME
  25. gstack \- print a stack trace of a running process
  26. .SH SYNOPSIS
  27. .B gstack
  28. pid
  29. .SH DESCRIPTION
  30. \f3gstack\f1 attaches to the active process named by the \f3pid\f1 on
  31. the command line, and prints out an execution stack trace. If ELF
  32. symbols exist in the binary (usually the case unless you have run
  33. strip(1)), then symbolic addresses are printed as well.
  34. If the process is part of a thread group, then \f3gstack\f1 will print
  35. out a stack trace for each of the threads in the group.
  36. .SH SEE ALSO
  37. nm(1), ptrace(2), gdb(1)
  38. .SH AUTHORS
  39. Ross Thompson <ross@whatsis.com>
  40. Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla>