Blame SOURCES/gdb-gstack.man

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