Blame SOURCES/gdb-gstack.man

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