Blame SOURCES/gdb-gstack.man

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