Blame SOURCES/gdb-gstack.man

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