Blame SOURCES/gdb-gstack.man

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