Blame SOURCES/gdb-gstack.man

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