Blame SOURCES/gdb-gstack.man

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