Blame SOURCES/gdb-gstack.man

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