Blame SOURCES/gdb-gstack.man

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