Blame SOURCES/gdb-gstack.man

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