Blame SOURCES/gdb-gstack.man

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