Blame SOURCES/gdb-gstack.man

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