Blame SOURCES/gdb-gstack.man

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