Blame SOURCES/gdb-gstack.man

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