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