Blame SOURCES/gdb-gstack.man

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