Blame SOURCES/gdb-gstack.man

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