Blame SOURCES/gdb-gstack.man

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