Blame SOURCES/gdb-gstack.man

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