Blame SOURCES/gdb-gstack.man

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